Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Cómo obtener los tokens de API de los clientes para WhatsApp, Instagram y TikTok

El Partner API de easyCoexistence devuelve el token de API y los IDs de una conexión de un cliente con un solo GET y ?credentials=1. Para un número de WhatsApp, /connections/{id} entrega waba_id, phone_number_id, la base de Graph API, el endpoint de envío y el token de negocio propio del cliente. Para una cuenta social, /channels/{id} entrega la base de API de la red, el ID de la cuenta en ella y un token de acceso renovado para ti, así que pídelo al inicio de cada trabajo.

?credentials=1

Agrega credentials a GET /connections/{id} para un número de WhatsApp y a GET /channels/{id} para una cuenta social.

1 hour

Vigencia de un token de acceso de usuario de Google, el que llevan las llamadas a la API de un canal de YouTube.

1 day

Vigencia de un token de acceso de cuenta de TikTok emitido por la API for Business; su token de actualización vale un año.

60 days

Cuánto dura un token de Instagram de larga duración renovado, contado desde el día en que se renovó.

No expiry

Los tokens de Página de larga duración de Meta no tienen fecha de caducidad, aunque ciertas condiciones pueden invalidarlos.

¿Qué llamada devuelve las credenciales de una conexión?

El GET propio del recurso con ?credentials=1, autenticado con tu clave ec_live_ como bearer token. Un número de WhatsApp está en /connections/{id} y una cuenta social en /channels/{id}, cada uno con su propio espacio de IDs: la redirección de conexión te entrega connection_id para un número y channel_id para una cuenta social. GET /connections y GET /channels las listan, y ?external_ref= limita cualquiera de las dos listas a un cliente. Sin el parámetro, las mismas llamadas devuelven la conexión sin token.

Credentials for a number and for a social account
# A WhatsApp number
curl "https://easycoexistence.com/api/v1/connections/$CONNECTION_ID?credentials=1" \
  -H "Authorization: Bearer $EC_API_KEY"

# A social account
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
  -H "Authorization: Bearer $EC_API_KEY"

¿Qué devuelve la llamada de credenciales de un número de WhatsApp?

La propia conexión más un objeto credentials. waba_id y phone_number_id identifican la WhatsApp Business Account y el número en la Graph API de Meta, y token_ready indica si hay un token de cliente registrado. Dentro de credentials, graph_api_base y send_endpoint ya incluyen la versión de la Graph API, y access_token es el token de negocio que Meta emitió cuando el cliente se conectó, limitado a ese cliente. Tu backend luego llama directamente a Meta para enviar, gestionar plantillas, subir medios y editar el perfil de empresa.

  • status: uno de connected, degraded, disconnected, banned, suspended, removed o unknown.
  • quality_rating y messaging_tier: la calificación de calidad de Meta, como GREEN, y el nivel de mensajería del número, como TIER_1K.
  • webhook_url: el webhook al que Meta envía los mensajes del número, o null.
  • disconnected_reason, last_checked_at, last_event_at y created_at: el motivo de desconexión de Meta cuando hay uno registrado, y marcas de tiempo ISO 8601.
GET /connections/{id}?credentials=1
{
  "id": "<CONNECTION_ID>",
  "external_ref": "customer_4821",
  "connect_session_id": "cs_…",
  "phone": "+55 11 9…",
  "name": "Clínica Sorriso",
  "waba_id": "<WABA_ID>",
  "phone_number_id": "<PHONE_NUMBER_ID>",
  "status": "connected",
  "quality_rating": "GREEN",
  "messaging_tier": "TIER_1K",
  "platform_type": "…",
  "token_ready": true,
  "webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
  "disconnected_reason": null,
  "last_checked_at": "2026-10-31T09:00:00.000Z",
  "last_event_at": "2026-10-31T08:41:12.000Z",
  "created_at": "2026-10-20T14:03:55.000Z",
  "credentials": {
    "graph_api_base": "https://graph.facebook.com/v25.0",
    "send_endpoint": "https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages",
    "access_token": "EAAG…",
    "note": "The customer's own business token, scoped to their assets. …"
  }
}

¿Qué devuelve la llamada de credenciales de cada red social?

La vista del canal, igual que GET /channels/{id}, con id, channel, external_ref, name, username, external_id, status y token_ready, más un objeto credentials. Las credenciales de cada red contienen platform, una base de API, el ID de la cuenta en esa red, access_token, token_expires_at, un token_note y ejemplos de llamadas. El campo de ID, y cualquier otra cosa que una red necesite, varían:

Instagramgraph_api_base https://graph.instagram.com/v25.0 and account_id_on_meta, the Instagram account's ID. A user token, refreshed before its 60 days run out.
Facebookgraph_api_base https://graph.facebook.com/v25.0 and account_id_on_meta, the Page ID. A Page token that does not expire while the Page stays connected.
TikTokapi_base https://business-api.tiktok.com/open_api/v1.3 and business_id. A day-long token, sent in an Access-Token header with business_id on each call.
YouTubeapi_base https://www.googleapis.com/youtube/v3, analytics_api_base for YouTube Analytics v2, and channel_id. An hour-long Google token, sent as a bearer token.
LinkedInapi_base https://api.linkedin.com/rest, author_urn for the Page or profile, and required_headers with LinkedIn-Version and X-Restli-Protocol-Version 2.0.0.

¿Por qué pedir el token social en cada trabajo en lugar de guardarlo?

Porque algunos rotan en menos de un día, y la llamada de credenciales siempre responde con un token válido en ese momento. El token de Google de YouTube dura una hora y el de TikTok un día, y easyCoexistence renueva ambos antes de que caduquen. El de Instagram dura 60 días y se renueva mucho antes, lo que emite un token nuevo. Un token de Página de Facebook no caduca mientras la Página siga conectada. Una sola petición al inicio de cada trabajo evita que tu código llame nunca a una red con un token vencido.

¿Debes guardar el token de un número de WhatsApp?

Sí. Es el token de negocio de Embedded Signup de Meta, que Meta limita a ese cliente incorporado, y la referencia te pide guardarlo de tu lado, ya que el panel no lo muestra. Léelo de nuevo después de cada evento connection.connected, porque una reconexión puede emitir uno nuevo. El token de un número suspendido o eliminado deja de servirse, y un token de cliente que Meta deja de aceptar mientras el número sigue respondiendo se retira, lo que pone token_ready en false.

¿Qué significan token_ready y token_missing?

token_ready es true cuando hay un token de cliente registrado y la conexión está activa. En un número puede ser false justo después de conectar, porque Meta a veces termina Embedded Signup sin emitir el token del cliente. La página alojada entonces pide al cliente una vez más, y tu endpoint de eventos recibe connection.token_missing. Si el cliente omite el paso, el número recibe mensajes, pues sus IDs son válidos, pero no puede enviar. Una nueva sesión de conexión para ese cliente emite el token y nunca reemplaza uno que ya funciona. Los canales sociales no tienen token_missing: su inicio de sesión siempre entrega el token propio del cliente, así que token_ready sigue a status.

¿Qué ocurre cuando una conexión no tiene token que entregar?

Un 200 cuyo credentials tiene access_token en null y una nota que indica qué hacer, en lugar de un error. Eso cubre un número con token_ready en false, un número suspendido o eliminado, y un canal cuyo status no es connected, donde la nota pide una nueva sesión de conexión. Un 404 not_found significa que el ID no está en tu cuenta, y un 502 credentials_unavailable significa que no se pudo obtener un token social nuevo en ese momento; reintenta, y revisa el status del canal si se repite.

Errores comunes

  • Guardar en un archivo de configuración el token de YouTube o TikTok. Caducan en una hora y en un día, así que llama al endpoint de credenciales al inicio de cada trabajo y deja la renovación a easyCoexistence.
  • Enviar desde un número cuyo token_ready es false. No hay token de cliente con el que llamar a Meta; abre una nueva sesión de conexión para ese cliente, que emite uno.
  • Llamar a TikTok con un encabezado Authorization. Su Business API recibe el token en un encabezado Access-Token, con el business_id de la cuenta en cada petición.
  • Llamar a LinkedIn solo con el bearer token. LinkedIn también exige los encabezados LinkedIn-Version y X-Restli-Protocol-Version listados en required_headers, y las URN en las rutas codificadas en URL.
Hacerlo con EasyCoexistence

easyCoexistence conecta los números de WhatsApp de tus clientes y sus cuentas de Instagram, Facebook, TikTok, YouTube y LinkedIn, y más canales, y luego entrega a tu backend las credenciales de cada conexión cuando las pides, con los tokens sociales renovados y cada conexión monitoreada 24/7. De US$ 9 a US$ 0.75 por conexión al mes, bajando conforme agregas conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿El token de WhatsApp es propio del cliente?

Sí. Es el token de negocio que Meta emite cuando el cliente se conecta mediante Embedded Signup, limitado a ese cliente. El token de sistema de easyCoexistence nunca se expone, y la llamada devuelve un token solo cuando token_ready es true.

¿Cuánto duran los tokens de acceso sociales?

Los de YouTube duran una hora, los de TikTok un día y los de Instagram hasta 60 días, mientras que un token de Página de Facebook no caduca. easyCoexistence renueva los que rotan, así que cada llamada de credenciales devuelve un token que funciona en ese momento.

¿Necesito mi propia app de desarrollador en cada red?

No. Los clientes inician sesión con la app propia de easyCoexistence en Meta, TikTok, Google y LinkedIn, y la llamada de credenciales entrega a tu backend el token para llamar directamente a la API de esa red.

¿Un asistente como Claude o ChatGPT puede leer las mismas credenciales?

Sí. Con sesión en tu cuenta mediante el servidor MCP, puede llamar a get_api_credentials para un número y a get_social_credentials para una cuenta social, que devuelve las mismas credenciales que el Partner API.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el