Como obter os tokens de API dos seus clientes para WhatsApp, Instagram e TikTok
A Partner API da easyCoexistence devolve o token de API e os IDs de um cliente com ligação, com um único GET e ?credentials=1. Para um número WhatsApp, /connections/{id} devolve waba_id, phone_number_id, a base da Graph API, o endpoint de envio e o token de negócio do próprio cliente. Para uma conta social, /channels/{id} devolve a base da API da rede, o ID da conta nessa rede e um access token renovado para si, pelo que deve pedi-lo no início de cada tarefa.
Acrescenta credenciais a GET /connections/{id} para um número WhatsApp e a GET /channels/{id} para uma conta social.
Validade de um access token de utilizador da Google, o tipo que levam as chamadas à API de um canal do YouTube.
Validade de um access token de conta TikTok obtido através da API for Business; o seu token de atualização é válido durante um ano.
Tempo de validade de um token de longa duração do Instagram já renovado, contado a partir do dia da renovação.
Os tokens de acesso de Página de longa duração da Meta não têm data de expiração, embora certas condições possam invalidá-los.
Que chamada devolve as credenciais de uma ligação?
O próprio GET do recurso com ?credentials=1, autenticado com a sua chave ec_live_ como bearer token. Um número WhatsApp está em /connections/{id} e uma conta social em /channels/{id}, cada um com o seu próprio espaço de IDs: o redirecionamento de ligação devolve connection_id para um número e channel_id para uma conta social. GET /connections e GET /channels listam-nas, e ?external_ref= restringe qualquer uma das listas a um cliente. Sem o parâmetro, as mesmas chamadas devolvem a ligação sem qualquer 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 devolve a chamada de credenciais de um número WhatsApp?
A própria ligação e um objeto credentials. waba_id e phone_number_id identificam a WhatsApp Business Account e o número na Graph API da Meta, e token_ready indica se há um token do cliente guardado. Dentro de credentials, graph_api_base e send_endpoint já incluem a versão da Graph API, e access_token é o token de negócio que a Meta emitiu quando o cliente ligou, limitado a esse cliente. O seu backend depois chama a Meta diretamente para enviar, gerir templates, carregar ficheiros multimédia e editar o perfil de negócio.
- status: connected, degraded, disconnected, banned, suspended, removed ou unknown.
quality_ratingemessaging_tier: a classificação 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 da desligação registado pela Meta, quando existe, e carimbos de data/hora 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 devolve a chamada de credenciais de cada rede social?
A vista 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 incluem platform, uma base da API, o ID da conta nessa rede, access_token, token_expires_at, token_note e exemplos de chamadas. O campo do ID, bem como qualquer outro dado que uma rede exija, varia:
Porque pedir um token social por tarefa em vez de o guardar?
Porque alguns são substituídos em menos de um dia, e a chamada de credenciais responde sempre com um token válido naquele momento. O token do Google para o YouTube dura uma hora e o do TikTok um dia, e a easyCoexistence renova os dois antes de expirarem. O do Instagram dura 60 dias e é renovado bem antes disso, o que emite um token novo. Um token de Página do Facebook não expira enquanto a Página estiver ligada. Um pedido no início de cada tarefa evita que o seu código chame alguma vez uma rede com um token caducado.
Deve guardar 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 já integrado, e a documentação pede que o guarde do seu lado, porque o painel não o mostra. Leia-o de novo após cada evento connection.connected, porque uma reconexão pode emitir um novo. O token de um número suspenso ou removido já não é servido, e um token de cliente que a Meta deixa de aceitar enquanto o número ainda responde é retirado, o que faz token_ready passar a false.
O que significam token_ready e token_missing?
token_ready é true quando há um token de cliente guardado e a ligação está ativa. Num número pode ser false logo após a ligação, porque a Meta por vezes conclui o Embedded Signup sem emitir o token do cliente. A página alojada pede então ao cliente mais uma passagem, e o seu endpoint de eventos recebe connection.token_missing. Se ele não a fizer, o número recebe mensagens, já que os seus IDs são válidos, mas não consegue enviar. Uma nova sessão de ligação para esse cliente emite o token e nunca substitui um que já funcione. Os canais sociais não têm token_missing: o início de sessão devolve sempre o token próprio do cliente, pelo que token_ready acompanha o status.
O que é devolvido quando uma ligação não tem token para dar?
Um 200 em que credentials tem access_token null e uma nota a indicar o que fazer, em vez de erro. Isto 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 ligaçã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 atualizado naquele momento; volte a tentar e, se o erro se repetir, verifique o status do canal.
Erros comuns
- Guardar em cache um token do YouTube ou do TikTok num ficheiro de configuração. Expiram em menos de uma hora e um dia, por isso chame o endpoint de credenciais no início de cada tarefa e deixe a renovação a cargo da easyCoexistence.
- Enviar a partir de um número com token_ready a false. Não há token do cliente com que chamar a Meta; abra uma nova sessão de ligação para esse cliente, que emite um.
- Chamar o TikTok com um cabeçalho Authorization. A sua Business API recebe o token num cabeçalho Access-Token, com o business_id da conta em cada pedido.
- Chamar o LinkedIn apenas com o bearer token. O LinkedIn exige também os cabeçalhos LinkedIn-Version e X-Restli-Protocol-Version listados em required_headers, e os URN nos caminhos codificados em URL.
A easyCoexistence liga os números WhatsApp dos seus clientes e as suas contas do Instagram, Facebook, TikTok, YouTube e LinkedIn, além de mais canais, e depois entrega ao seu backend as credenciais de cada ligação sempre que as pedir, com os tokens sociais renovados e cada ligação monitorizada 24/7. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
O token do WhatsApp é o próprio do cliente?
Sim. É o token de negócio que a Meta emite quando o cliente liga através do Embedded Signup, limitado a esse cliente. O token de sistema da easyCoexistence nunca é exposto, e a chamada só devolve um token quando token_ready é true.
Quanto tempo duram os access tokens 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 caducam, por isso cada chamada de credenciais devolve um token que funciona neste momento.
Preciso de uma aplicação de programador própria em cada rede?
Não. Os clientes iniciam sessão através da aplicação própria da easyCoexistence na Meta, TikTok, Google e LinkedIn, e a chamada de credenciais entrega ao seu backend o token para chamar diretamente a API dessa rede.
Um assistente como o Claude ou o ChatGPT consegue ler as mesmas credenciais?
Sim. Com sessão iniciada na sua conta através do servidor MCP, pode chamar get_api_credentials para um número e get_social_credentials para uma conta social, que devolve as mesmas credenciais da Partner API.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em