Comment obtenir les tokens API de vos clients pour WhatsApp, Instagram et TikTok
La Partner API d'easyCoexistence renvoie le token API et les identifiants d'un client connecté avec un seul GET et ?credentials=1. Pour un numéro WhatsApp, /connections/{id} fournit waba_id, phone_number_id, la base Graph API, l'endpoint d'envoi et le token d'entreprise propre au client. Pour un compte social, /channels/{id} fournit la base d'API du réseau, l'identifiant du compte sur ce réseau et un token d'accès renouvelé pour vous, donc récupérez-le au début de chaque tâche.
Ajoute credentials à GET /connections/{id} pour un numéro WhatsApp et à GET /channels/{id} pour un compte social.
Durée de vie d'un token d'accès utilisateur Google, celui qu'utilisent les appels API d'une chaîne YouTube.
Durée de validité d'un token d'accès de compte TikTok, issu de l'API for Business ; son refresh token reste valable un an.
Durée de validité d'un token Instagram longue durée rafraîchi, comptée à partir du jour de son rafraîchissement.
Les tokens d'accès de Page longue durée de Meta n'ont pas de date d'expiration, mais certaines conditions peuvent les invalider.
Quel appel renvoie les identifiants d'une connexion ?
Le GET propre à la ressource, avec ?credentials=1, authentifié par votre clé ec_live_ en bearer token. Un numéro WhatsApp se trouve sur /connections/{id} et un compte social sur /channels/{id}, chacun avec son propre espace d'identifiants : la redirection de connexion vous remet connection_id pour un numéro et channel_id pour un compte social. GET /connections et GET /channels les listent, et ?external_ref= restreint l'une ou l'autre liste à un seul client. Sans ce paramètre, les mêmes appels renvoient la connexion sans 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"Que renvoie l'appel de credentials d'un numéro WhatsApp ?
La connexion elle-même, plus un objet credentials. waba_id et phone_number_id identifient le WhatsApp Business Account et le numéro dans la Graph API de Meta, et token_ready indique si un token client est enregistré. Dans credentials, graph_api_base et send_endpoint intègrent déjà la version de la Graph API, et access_token est le token d'entreprise émis par Meta lors de la connexion du client, limité à ce client. Votre backend appelle ensuite Meta directement pour envoyer des messages, gérer les templates, téléverser des médias et modifier le profil d'entreprise.
- status : connected, degraded, disconnected, banned, suspended, removed ou unknown.
quality_ratingetmessaging_tier: la note de Meta, comme GREEN, et le palier du numéro, commeTIER_1K.webhook_url: l'webhook vers lequel Meta envoie les messages du numéro, ou null.disconnected_reason,last_checked_at,last_event_atetcreated_at: la raison de déconnexion indiquée par Meta lorsqu'elle est enregistrée, et des horodatages 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. …"
}
}Que renvoie l'appel de credentials de chaque réseau social ?
La vue du canal, identique à GET /channels/{id}, avec id, channel, external_ref, name, username, external_id, status et token_ready, plus un objet credentials. Les credentials de chaque réseau contiennent platform, une base d'API, l'identifiant du compte sur ce réseau, access_token, token_expires_at, token_note et des exemples d'appels. Le champ d'identifiant, et tout ce dont un réseau a besoin, diffèrent :
Pourquoi récupérer un token social à chaque tâche plutôt que de le stocker ?
Parce que certains tokens tournent en moins d'un jour, et que l'appel de credentials renvoie toujours un token valide à l'instant où il est fait. Le token Google de YouTube dure une heure et celui de TikTok un jour, et easyCoexistence les renouvelle tous deux avant leur expiration. Celui d'Instagram dure 60 jours et est rafraîchi bien avant, ce qui émet un nouveau token. Un token de Page Facebook n'expire pas tant que la Page reste connectée. Une seule requête au début de chaque tâche évite à votre code d'appeler un réseau avec un token expiré.
Faut-il stocker le token d'un numéro WhatsApp ?
Oui. Il s'agit du token d'entreprise issu de l'Embedded Signup de Meta, que Meta limite à ce client intégré, et la référence vous demande de le stocker de votre côté, car le dashboard ne l'affiche pas. Relisez-le après chaque événement connection.connected, car une reconnexion peut en émettre un nouveau. Le token d'un numéro suspendu ou supprimé n'est plus servi, et un token client que Meta cesse d'accepter alors que le numéro répond encore est retiré, ce qui fait passer token_ready à false.
Que signifient token_ready et token_missing ?
token_ready vaut true lorsqu'un token client est enregistré et que la connexion est active. Sur un numéro, il peut valoir false juste après la connexion, car Meta termine parfois l'Embedded Signup sans émettre le token du client. La page hébergée demande alors au client de repasser une fois de plus, et votre endpoint d'événements reçoit connection.token_missing. S'il ignore cette étape, le numéro reçoit les messages, car ses identifiants sont valides, mais ne peut pas en envoyer. Une nouvelle session de connexion pour ce client émet le token sans jamais remplacer celui qui fonctionne déjà. Les canaux sociaux n'ont pas de token_missing : leur connexion donne toujours le token propre au client, donc token_ready suit status.
Que se passe-t-il lorsqu'une connexion n'a pas de token à fournir ?
Une réponse 200 dont credentials contient access_token à null et une note indiquant la marche à suivre, plutôt qu'une erreur. C'est le cas d'un numéro dont token_ready vaut false, d'un numéro suspendu ou supprimé, et d'un canal dont le status n'est pas connected ; la note demande alors une nouvelle session de connexion. Une réponse 404 not_found signifie que l'identifiant n'est pas sur votre compte, et une réponse 502 credentials_unavailable signifie qu'un token social récent n'a pas pu être obtenu à cet instant : réessayez, et vérifiez le status du canal si l'erreur se répète.
Erreurs courantes
- Mettre en cache un token YouTube ou TikTok dans un fichier de configuration. Ils expirent en une heure et en un jour, donc appelez l'endpoint de credentials au début de chaque tâche et laissez le renouvellement à easyCoexistence.
- Envoyer depuis un numéro dont token_ready vaut false. Il n'existe aucun token client pour appeler Meta ; ouvrez une nouvelle session de connexion pour ce client, qui en émet un.
- Appeler TikTok avec un en-tête Authorization. Son Business API attend le token dans un en-tête Access-Token, avec le business_id du compte dans chaque requête.
- Appeler LinkedIn avec le seul bearer token. LinkedIn exige aussi les en-têtes LinkedIn-Version et X-Restli-Protocol-Version listés dans required_headers, et les URN dans les chemins doivent être encodés en URL.
easyCoexistence connecte les numéros WhatsApp de vos clients ainsi que leurs comptes Instagram, Facebook, TikTok, YouTube et LinkedIn, et d'autres canaux encore. Il remet ensuite à votre backend les identifiants de chaque connexion sur demande, avec des tokens sociaux renouvelés et chaque connexion surveillée 24/7. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.
Questions fréquemment posées
Le token WhatsApp est-il celui du client ?
Oui. C'est le token d'entreprise que Meta émet lorsque le client se connecte via l'Embedded Signup, limité à ce client. Le token système d'easyCoexistence n'est jamais exposé, et l'appel ne renvoie un token que lorsque token_ready vaut true.
Quelle est la durée de vie des tokens d'accès aux réseaux sociaux ?
Celui de YouTube dure une heure, celui de TikTok un jour et celui d'Instagram jusqu'à 60 jours, tandis qu'un token de Page Facebook n'expire pas. easyCoexistence renouvelle ceux qui expirent, si bien que chaque appel de credentials renvoie un token valide à cet instant.
Ai-je besoin de ma propre application développeur sur chaque réseau ?
Non. Vos clients se connectent via l'application propre d'easyCoexistence sur Meta, TikTok, Google et LinkedIn, et l'appel de credentials remet à votre backend le token nécessaire pour appeler directement l'API de ce réseau.
Un assistant comme Claude ou ChatGPT peut-il lire les mêmes identifiants ?
Oui. Connecté à votre compte via le serveur MCP, il peut appeler get_api_credentials pour un numéro et get_social_credentials pour un compte social, qui renvoie les mêmes identifiants que la Partner API.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le