InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Hoe je de API-tokens van je klanten voor WhatsApp, Instagram en TikTok ophaalt

De Partner API van easyCoexistence geeft het API-token en de ID's van een verbonden klant terug met één GET en ?credentials=1. Voor een WhatsApp-nummer geeft /connections/{id} de waba_id, phone_number_id, de Graph API-basis, het send-endpoint en het eigen token van de klant. Voor een socialmediaaccount geeft /channels/{id} de API-basis van het netwerk, het ID van het account daar en een toegangstoken dat voor je wordt vernieuwd, dus haal het aan het begin van elke taak op.

?credentials=1

Voegt credentials toe aan GET /connections/{id} voor een WhatsApp-nummer en aan GET /channels/{id} voor een socialmediaaccount.

1 hour

Levensduur van een Google-gebruikerstoegangstoken, het type waarmee de API-aanroepen van een YouTube-kanaal werken.

1 day

Geldigheid van een TikTok-toegangstoken voor het account uit de API for Business; het vernieuwingstoken is één jaar geldig.

60 days

Hoe lang een vernieuwd long-lived Instagram-token geldig blijft, gerekend vanaf de dag van vernieuwing.

No expiry

Meta's long-lived Page-toegangstokens hebben geen vervaldatum, al kunnen bepaalde voorwaarden ze ongeldig maken.

Welke aanroep geeft de credentials van een verbinding terug?

De eigen GET van het object met ?credentials=1, geauthenticeerd met je ec_live_-sleutel als bearer-token. Een WhatsApp-nummer staat op /connections/{id} en een socialmediaaccount op /channels/{id}, elk met een eigen ID-namespace: de connect-redirect geeft je connection_id voor een nummer en channel_id voor een socialmediaaccount. GET /connections en GET /channels tonen ze in een lijst, en met ?external_ref= filter je beide lijsten op één klant. Zonder de parameter geven dezelfde aanroepen de verbinding terug zonder token erin.

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"

Wat geeft de credentials-aanroep van een WhatsApp-nummer terug?

De verbinding zelf plus een credentials-object. waba_id en phone_number_id identificeren het WhatsApp Business Account en het nummer in de Graph API van Meta, en token_ready geeft aan of er een token van de klant is opgeslagen. Binnen credentials bevatten graph_api_base en send_endpoint al de Graph API-versie, en access_token is het bedrijfstoken dat Meta heeft uitgegeven toen de klant verbond, beperkt tot die klant. Je backend roept Meta daarna rechtstreeks aan om te versturen, templates te beheren, media te uploaden en het bedrijfsprofiel te bewerken.

  • status: connected, degraded, disconnected, banned, suspended, removed of unknown.
  • quality_rating en messaging_tier: de beoordeling van Meta, zoals GREEN, en het niveau van het nummer, zoals TIER_1K.
  • webhook_url: waar Meta de berichten van het nummer naartoe stuurt, of null.
  • disconnected_reason, last_checked_at, last_event_at en created_at: de reden van ontkoppeling van Meta als die is vastgelegd, en ISO 8601-tijdstempels.
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. …"
  }
}

Wat geeft de credentials-aanroep van elk socialmedianetwerk terug?

De weergave van het kanaal, gelijk aan GET /channels/{id}, met id, channel, external_ref, name, username, external_id, status en token_ready, plus een credentials-object. De credentials van elk netwerk bevatten platform, een API-basis, het ID van het account op dat netwerk, access_token, token_expires_at, een token_note en voorbeeldaanroepen. Het ID-veld, en alles wat een netwerk verder nodig heeft, verschilt:

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.

Waarom een social token per taak ophalen in plaats van het op te slaan?

Omdat sommige binnen een dag vernieuwen, en de credentials-aanroep altijd antwoordt met een token dat op dat moment geldig is. Het Google-token van YouTube geldt een uur en dat van TikTok een dag, en easyCoexistence vernieuwt beide voordat ze verlopen. Dat van Instagram geldt 60 dagen en wordt ruim daarvoor vernieuwd, waarbij een nieuw token wordt uitgegeven. Een Facebook Page-token verloopt niet zolang de Page verbonden blijft. Eén verzoek aan het begin van elke taak zorgt ervoor dat je code nooit een netwerk aanroept met een verlopen token.

Moet je het token van een WhatsApp-nummer opslaan?

Ja. Het is het bedrijfstoken uit Meta's Embedded Signup, dat Meta beperkt tot die klant die is aangesloten, en de referentie vraagt je het aan jouw kant op te slaan, omdat het dashboard het niet toont. Lees het opnieuw na elk connection.connected-event, want bij een opnieuw verbinden kan Meta een nieuw token uitgeven. Het token van een geschorst of verwijderd nummer wordt niet meer geleverd, en een klanttoken dat Meta niet langer accepteert terwijl het nummer nog antwoordt, wordt ingetrokken, waardoor token_ready op false komt te staan.

Wat betekenen token_ready en token_missing?

token_ready is true wanneer er een klanttoken is opgeslagen en de verbinding actief is. Bij een nummer kan het direct na het verbinden false zijn, omdat Meta de Embedded Signup soms afrondt zonder het klanttoken uit te geven. De gehoste pagina vraagt de klant dan om nog één keer te doorlopen, en je events-endpoint ontvangt connection.token_missing. Slaat de klant dat over, dan ontvangt het nummer berichten, want de ID's zijn geldig, maar kan het niet versturen. Een nieuwe verbindingssessie voor die klant geeft het token uit en vervangt nooit een token dat al werkt. Socialmediakanalen hebben geen token_missing: hun aanmelding levert altijd het eigen token van de klant op, dus token_ready volgt de status.

Wat komt er terug als een verbinding geen token te geven heeft?

Een 200 waarvan credentials access_token null bevat en een notitie over wat je moet doen, in plaats van een fout. Dat geldt voor een nummer met token_ready false, een geschorst of verwijderd nummer, en een kanaal waarvan de status niet connected is; in dat geval vraagt de notitie om een nieuwe verbindingssessie. Een 404 not_found betekent dat het ID niet op jouw account staat, en een 502 credentials_unavailable betekent dat er op dat moment geen nieuw socialtoken kon worden verkregen; probeer het opnieuw en controleer de status van het kanaal als het zich herhaalt.

Veelgemaakte fouten

  • Een YouTube- of TikTok-token in een configuratiebestand cachen. Ze verlopen binnen een uur respectievelijk een dag, dus roep het credentials-endpoint aan het begin van elke taak aan en laat de vernieuwing aan easyCoexistence over.
  • Versturen vanaf een nummer waarvan token_ready false is. Er is dan geen klanttoken om Meta mee aan te roepen; open een nieuwe verbindingssessie voor die klant, die er een uitgeeft.
  • TikTok aanroepen met een Authorization-header. De Business API verwacht het token in een Access-Token-header, met de business_id van het account in elk verzoek.
  • LinkedIn aanroepen met alleen het bearer-token. LinkedIn wil ook de headers LinkedIn-Version en X-Restli-Protocol-Version die in required_headers staan, en URN's in paden URL-gecodeerd.
Dit doen met EasyCoexistence

easyCoexistence verbindt de WhatsApp-nummers van je klanten en hun Instagram-, Facebook-, TikTok-, YouTube- en LinkedIn-accounts, en meer kanalen. Op verzoek geeft het je backend de credentials van elke verbinding, met vernieuwde socialtokens, en elke verbinding wordt 24/7 bewaakt. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Is het WhatsApp-token van de klant zelf?

Ja. Het is het bedrijfstoken dat Meta uitgeeft wanneer de klant via Embedded Signup verbindt, beperkt tot die klant. Het systeemtoken van easyCoexistence wordt nooit getoond, en de aanroep geeft alleen een token terug wanneer token_ready true is.

Hoe lang blijven socialtoegangstokens geldig?

Dat van YouTube geldt een uur, dat van TikTok een dag en dat van Instagram tot 60 dagen, terwijl een Facebook Page-token niet verloopt. easyCoexistence vernieuwt de tokens die roteren, zodat elke credentials-aanroep een token geeft dat nu werkt.

Heb ik per netwerk een eigen developerapp nodig?

Nee. Klanten melden zich aan via de eigen app van easyCoexistence bij Meta, TikTok, Google en LinkedIn, en de credentials-aanroep geeft je backend het token om die API van het netwerk rechtstreeks aan te roepen.

Kan een assistent zoals Claude of ChatGPT dezelfde credentials lezen?

Ja. Wanneer je bent ingelogd op je account via de MCP-server, kan die get_api_credentials voor een nummer aanroepen en get_social_credentials voor een socialmediaaccount, wat dezelfde credentials teruggeeft als de Partner API.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op