Como obter os tokens de API dos seus clientes para WhatsApp, Instagram e TikTok
A Partner API da easyCoexistence retorna o token de API e os IDs de um cliente conectado com um único GET e ?credentials=1. Para um número de WhatsApp, /connections/{id} traz waba_id, phone_number_id, a base da Graph API, o endpoint de envio e o token de negócio próprio do cliente. Para uma conta social, /channels/{id} traz a base da API da rede, o ID da conta nela e um access token renovado para você, então busque-o no início de cada tarefa.
Acrescenta credentials a GET /connections/{id} para um número WhatsApp e a GET /channels/{id} para uma conta social.
Validade de um token de acesso de usuário do Google, o tipo que as chamadas à API de um canal do YouTube carregam.
Validade de um token de acesso de conta do TikTok obtido pela API for Business; seu refresh token vale por um ano.
Por quanto tempo um token longo do Instagram renovado continua válido, contado a partir do dia em que foi renovado.
Os tokens de Página de longa duração da Meta não têm data de expiração, embora certas condições possam invalidá-los.
Qual chamada retorna as credenciais de uma conexão?
O próprio GET do recurso com ?credentials=1, autenticado com sua chave ec_live_ como bearer token. Um número WhatsApp fica em /connections/{id} e uma conta social em /channels/{id}, cada uma com seu próprio namespace de IDs: o redirecionamento de conexão entrega connection_id para um número e channel_id para uma conta social. GET /connections e GET /channels listam as conexões, e ?external_ref= restringe qualquer uma das listas a um cliente. Sem o parâmetro, as mesmas chamadas retornam a conexão sem token.
# 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"O que a chamada de credenciais de um número WhatsApp retorna?
A própria conexão mais um objeto credentials. waba_id e phone_number_id identificam a conta WhatsApp Business e o número na Graph API da Meta, e token_ready indica se há um token do cliente registrado. Dentro de credentials, graph_api_base e send_endpoint já trazem a versão da Graph API, e access_token é o token de negócio que a Meta emitiu quando o cliente se conectou, limitado a esse cliente. Seu backend então chama a Meta diretamente para enviar mensagens, gerenciar templates, fazer upload de mídia e editar o perfil comercial.
- status: connected, degraded, disconnected, banned, suspended, removed ou unknown.
quality_ratingemessaging_tier: a classificação de qualidade da Meta, como GREEN, e o nível do número, comoTIER_1K.webhook_url: para onde a Meta envia as mensagens do número, ou null.disconnected_reason,last_checked_at,last_event_atecreated_at: o motivo de desconexão registrado pela Meta, quando houver, e timestamps ISO 8601.
{
"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. …"
}
}O que a chamada de credenciais de cada rede social retorna?
A visão do canal, igual a GET /channels/{id}, com id, channel, external_ref, name, username, external_id, status e token_ready, mais um objeto credentials. As credenciais de cada rede trazem platform, uma base de API, o ID da conta nessa rede, access_token, token_expires_at, uma token_note e exemplos de chamadas. O campo de ID, e qualquer outra coisa de que a rede precise, varia:
Por que buscar o token de uma rede social a cada tarefa em vez de armazená-lo?
Porque alguns rotacionam em menos de um dia, e a chamada de credenciais sempre responde com um token válido naquele momento. O token do Google do YouTube dura uma hora e o do TikTok um dia, e a easyCoexistence renova os dois antes que expirem. O do Instagram dura 60 dias e é renovado bem antes disso, o que emite um novo token. O token de Página do Facebook não expira enquanto a Página permanecer conectada. Uma requisição no início de cada tarefa evita que seu código chame uma rede com um token vencido.
Você deve armazenar o token de um número WhatsApp?
Sim. É o token de negócio do Embedded Signup da Meta, que a Meta limita a esse cliente integrado, e a referência pede que você o armazene do seu lado, já que o painel não o mostra. Leia-o novamente após cada evento connection.connected, porque uma reconexão pode emitir um novo. O token de um número suspenso ou removido deixa de ser servido, e um token do cliente que a Meta para de aceitar enquanto o número ainda responde é aposentado, o que faz token_ready voltar a false.
O que significam token_ready e token_missing?
token_ready é true quando há um token do cliente registrado e a conexão está ativa. Em um número, ele pode ser false logo após a conexão, porque a Meta às vezes conclui o Embedded Signup sem emitir o token do cliente. A página hospedada então pede ao cliente mais uma execução, e seu endpoint de eventos recebe connection.token_missing. Se ele pular a etapa, o número recebe mensagens, pois seus IDs são válidos, mas não consegue enviar. Uma nova sessão de conexão para esse cliente emite o token e nunca substitui um que já funciona. Os canais sociais não têm token_missing: o login deles sempre entrega o token próprio do cliente, então token_ready acompanha o status.
O que é devolvido quando uma conexão não tem token a entregar?
Um 200 cujo credentials traz access_token null e uma nota dizendo o que fazer, em vez de erro. Isso cobre um número com token_ready false, um número suspenso ou removido, e um canal cujo status não é connected, caso em que a nota pede uma nova sessão de conexão. Um 404 not_found significa que o ID não está na sua conta, e um 502 credentials_unavailable significa que não foi possível obter um token social novo naquele momento; repita a requisição e verifique o status do canal se o erro persistir.
Erros comuns
- Guardar em um arquivo de configuração o token do YouTube ou do TikTok. Eles expiram em uma hora e em um dia, então chame o endpoint de credenciais no início de cada tarefa e deixe a renovação com a easyCoexistence.
- Enviar a partir de um número com token_ready false. Não há token do cliente para chamar a Meta; abra uma nova sessão de conexão para esse cliente, que emite um.
- Chamar o TikTok com um cabeçalho Authorization. Sua Business API recebe o token em um cabeçalho Access-Token, com o business_id da conta em toda requisição.
- Chamar o LinkedIn apenas com o bearer token. O LinkedIn também exige os cabeçalhos LinkedIn-Version e X-Restli-Protocol-Version listados em required_headers, e os URNs nos caminhos devem ser codificados em URL.
A easyCoexistence conecta os números de WhatsApp dos seus clientes e as contas de Instagram, Facebook, TikTok, YouTube e LinkedIn deles, além de outros canais, depois entrega ao seu backend as credenciais de cada conexão quando solicitadas, com os tokens sociais renovados e cada conexão monitorada 24/7. De US$ 9 a US$ 0.75 por conexão por mês, caindo à medida que você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O token do WhatsApp é do próprio cliente?
Sim. É o token de negócio que a Meta emite quando o cliente se conecta pelo Embedded Signup, limitado a esse cliente. O token de sistema da easyCoexistence nunca é exposto, e a chamada só retorna um token quando token_ready é true.
Por quanto tempo duram os tokens de acesso das redes sociais?
O do YouTube dura uma hora, o do TikTok um dia e o do Instagram até 60 dias, enquanto um token de Página do Facebook não expira. A easyCoexistence renova os que rotacionam, então cada chamada de credenciais retorna um token que funciona naquele momento.
Preciso de um app de desenvolvedor próprio em cada rede?
Não. Os clientes entram pelo app da própria easyCoexistence na Meta, no TikTok, no Google e no LinkedIn, e a chamada de credenciais entrega ao seu backend o token para chamar diretamente a API dessa rede.
Um assistente como Claude ou ChatGPT pode ler as mesmas credenciais?
Sim. Conectado à sua conta pelo servidor MCP, ele pode chamar get_api_credentials para um número e get_social_credentials para uma conta social, que retorna as mesmas credenciais da Partner API.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em