So erhalten Sie die API-Tokens Ihrer Kunden für WhatsApp, Instagram und TikTok
Die Partner API von easyCoexistence gibt das API-Token und die IDs einer Kundenverbindung mit einem einzigen GET und ?credentials=1 zurück. Für eine WhatsApp-Nummer liefert /connections/{id} waba_id, phone_number_id, die Graph-API-Basis, den Send-Endpoint und das eigene Business-Token des Kunden. Für ein Social-Media-Konto liefert /channels/{id} die API-Basis des Netzwerks, die dortige Konto-ID und ein für Sie erneuertes Access-Token. Rufen Sie es daher zu Beginn jedes Jobs ab.
Ergänzt credentials in GET /connections/{id} für eine WhatsApp-Nummer und in GET /channels/{id} für ein Social-Media-Konto.
Lebensdauer eines Google-User-Access-Tokens, wie es die API-Aufrufe eines YouTube-Kanals mitführen.
Gültigkeit eines TikTok-Konto-Access-Tokens aus der API for Business; sein Refresh-Token ist ein Jahr gültig.
Wie lange ein erneuertes langlebiges Instagram-Token gültig bleibt, gerechnet ab dem Tag der Erneuerung.
Metas langlebige Page-Access-Tokens haben kein Ablaufdatum, können aber unter bestimmten Bedingungen ungültig werden.
Welcher Aufruf liefert die Zugangsdaten einer Verbindung?
Der GET der Ressource selbst mit ?credentials=1, authentifiziert mit Ihrem ec_live_-Schlüssel als Bearer-Token. Eine WhatsApp-Nummer liegt unter /connections/{id}, ein Social-Media-Konto unter /channels/{id}, jeweils mit eigenem ID-Namensraum: Der Connect-Redirect übergibt connection_id für eine Nummer und channel_id für ein Social-Media-Konto. GET /connections und GET /channels listen sie auf, und mit ?external_ref= lässt sich jede Liste auf einen Kunden eingrenzen. Ohne den Parameter liefern dieselben Aufrufe die Verbindung ohne 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"Was liefert der Zugangsdaten-Abruf einer WhatsApp-Nummer?
Die Verbindung selbst plus ein credentials-Objekt. waba_id und phone_number_id kennzeichnen das WhatsApp Business Account und die Nummer in Metas Graph API, und token_ready zeigt an, ob ein Kunden-Token hinterlegt ist. Innerhalb von credentials tragen graph_api_base und send_endpoint bereits die Graph-API-Version, und access_token ist das Business-Token, das Meta bei der Verbindung des Kunden ausgestellt hat und das auf diesen Kunden beschränkt ist. Ihr Backend ruft danach Meta direkt auf, um zu senden, Templates zu verwalten, Medien hochzuladen und das Business-Profil zu bearbeiten.
- status: connected, degraded, disconnected, banned, suspended, removed oder unknown.
quality_ratingundmessaging_tier: Metas Bewertung, etwa GREEN, und die Stufe der Nummer, etwaTIER_1K.webhook_url: Ziel, an das Meta die Nachrichten der Nummer sendet, oder null.disconnected_reason,last_checked_at,last_event_atundcreated_at: Metas Trennungsgrund, sofern einer vorliegt, und ISO-8601-Zeitstempel.
{
"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. …"
}
}Was liefert der Zugangsdaten-Abruf jedes sozialen Netzwerks?
Die Kanalansicht wie bei GET /channels/{id}, mit id, channel, external_ref, name, username, external_id, status und token_ready, dazu ein credentials-Objekt. Die Zugangsdaten jedes Netzwerks enthalten platform, eine API-Basis, die Konto-ID dort, access_token, token_expires_at, eine token_note und Beispielaufrufe. Das ID-Feld und alles, was ein Netzwerk sonst braucht, unterscheiden sich:
Warum ein Social-Token pro Job abrufen, statt es zu speichern?
Weil manche innerhalb eines Tages rotieren und der Zugangsdaten-Abruf stets ein im Moment gültiges Token liefert. Das Google-Token von YouTube hält eine Stunde, das von TikTok einen Tag, und easyCoexistence erneuert beide, bevor sie ablaufen. Das Instagram-Token hält 60 Tage und wird lange vorher erneuert, wodurch ein neues Token entsteht. Ein Facebook-Page-Token läuft nicht ab, solange die Page verbunden bleibt. Eine Anfrage zu Beginn jedes Jobs sorgt dafür, dass Ihr Code nie ein abgelaufenes Token an ein Netzwerk sendet.
Sollten Sie das Token einer WhatsApp-Nummer speichern?
Ja. Es ist das Business-Token aus Metas Embedded Signup, das Meta auf den eingebundenen Kunden beschränkt. Die Referenz empfiehlt, es auf Ihrer Seite zu speichern, da das Dashboard es nicht anzeigt. Lesen Sie es nach jedem connection.connected-Ereignis erneut, denn eine Wiederverbindung kann ein neues ausstellen. Das Token einer gesperrten oder entfernten Nummer wird nicht mehr ausgeliefert. Ein Kunden-Token, das Meta nicht mehr akzeptiert, während die Nummer weiter antwortet, wird ausgemustert, wodurch token_ready auf false wechselt.
Was bedeuten token_ready und token_missing?
token_ready ist true, wenn ein Kunden-Token hinterlegt und die Verbindung aktiv ist. Bei einer Nummer kann es direkt nach der Verbindung false sein, weil Meta das Embedded Signup manchmal abschließt, ohne das Kunden-Token auszustellen. Die gehostete Seite bittet den Kunden dann um einen weiteren Durchlauf, und Ihr Event-Endpoint erhält connection.token_missing. Überspringt der Kunde den Schritt, empfängt die Nummer Nachrichten, da ihre IDs gültig sind, kann aber nicht senden. Eine neue Verbindungssitzung für diesen Kunden stellt das Token aus und ersetzt nie eines, das bereits funktioniert. Social-Kanäle kennen kein token_missing: Ihre Anmeldung liefert immer das eigene Token des Kunden, daher folgt token_ready dem status.
Was kommt zurück, wenn eine Verbindung kein Token liefern kann?
Eine 200-Antwort, deren credentials access_token: null enthalten und einen Hinweis, was zu tun ist, statt eines Fehlers. Das gilt für eine Nummer mit token_ready false, für eine gesperrte oder entfernte Nummer und für einen Kanal, dessen status nicht connected ist; dort fordert der Hinweis eine neue Verbindungssitzung an. Ein 404 not_found bedeutet, dass die ID nicht zu Ihrem Konto gehört, und ein 502 credentials_unavailable, dass sich in diesem Moment kein frisches Social-Token beschaffen ließ. Versuchen Sie es dann erneut, und prüfen Sie den status des Kanals, falls es sich wiederholt.
Häufige Fehler
- YouTube- oder TikTok-Token in einer Konfigurationsdatei zwischenspeichern. Sie laufen nach einer Stunde beziehungsweise einem Tag ab. Rufen Sie daher den credentials-Endpoint zu Beginn jedes Jobs auf und überlassen Sie die Erneuerung easyCoexistence.
- Von einer Nummer senden, deren token_ready false ist. Dann gibt es kein Kunden-Token, mit dem Sie Meta aufrufen könnten. Öffnen Sie eine neue Verbindungssitzung für diesen Kunden, die eines ausstellt.
- TikTok mit einem Authorization-Header aufrufen. Dessen Business API erwartet das Token in einem Access-Token-Header, zusammen mit der business_id des Kontos in jeder Anfrage.
- LinkedIn nur mit dem Bearer-Token aufrufen. LinkedIn verlangt außerdem die Header LinkedIn-Version und X-Restli-Protocol-Version, die in required_headers aufgelistet sind, und URNs in Pfaden müssen URL-kodiert sein.
easyCoexistence verbindet die WhatsApp-Nummern Ihrer Kunden sowie deren Instagram-, Facebook-, TikTok-, YouTube- und LinkedIn-Konten und weitere Kanäle. Ihrem Backend übergibt es auf Anfrage die Zugangsdaten jeder Verbindung, mit erneuerten Social-Tokens, und überwacht jede Verbindung rund um die Uhr. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, die ersten 3 Tage kostenlos.
Häufig gestellte Fragen
Ist das WhatsApp-Token das eigene des Kunden?
Ja. Es ist das Business-Token, das Meta bei der Verbindung des Kunden über Embedded Signup ausstellt und das auf diesen Kunden beschränkt ist. Das Systemtoken von easyCoexistence wird nie offengelegt, und der Aufruf liefert nur dann ein Token, wenn token_ready true ist.
Wie lange gelten Social-Access-Tokens?
YouTube-Tokens halten eine Stunde, TikTok-Tokens einen Tag und Instagram-Tokens bis zu 60 Tage, während ein Facebook-Page-Token nicht abläuft. easyCoexistence erneuert die, die rotieren, daher liefert jeder Zugangsdaten-Abruf ein Token, das jetzt funktioniert.
Brauche ich eine eigene Entwickler-App bei jedem Netzwerk?
Nein. Kunden melden sich über die eigene App von easyCoexistence bei Meta, TikTok, Google und LinkedIn an. Der Zugangsdaten-Abruf übergibt Ihrem Backend dann das Token, mit dem Sie die API des jeweiligen Netzwerks direkt aufrufen.
Kann ein Assistent wie Claude oder ChatGPT dieselben Zugangsdaten lesen?
Ja. Angemeldet an Ihrem Konto über den MCP-Server, kann er get_api_credentials für eine Nummer und get_social_credentials für ein Social-Media-Konto aufrufen. Das liefert dieselben Zugangsdaten wie die Partner API.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am