AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

So lassen Sie Ihre Nutzer WhatsApp-, Instagram- und TikTok-Konten mit Ihrer App verbinden

Um Ihren Nutzern das Verbinden von WhatsApp-, Instagram- und TikTok-Konten mit Ihrer App zu ermöglichen, erstellen Sie eine Verbindungssitzung über die Partner API von easyCoexistence und senden den Nutzer an deren gehostete URL. Dort verbinden sie eine WhatsApp-Nummer über das Embedded Signup von Meta oder melden sich bei Instagram, Facebook, TikTok, YouTube, LinkedIn und weiteren Kanälen an. Anschließend kehren sie zu Ihrer redirect_url zurück, mit der neuen connection_id oder channel_id. Links bleiben eine Stunde gültig.

1 hour

Wie lange ein Verbindungslink funktioniert; danach zeigt die Sitzung den Status expired, und ein neuer Link ist nötig.

50 open

Verbindungssitzungen, die ein Konto gleichzeitig offen halten kann, neben einem Limit von 100 neuen Sitzungen pro Stunde.

5 statuses

Eine Sitzung ist created, opened, connected, cancelled oder expired, wie GET /connect-sessions/:id angibt.

200 characters

Die längste alternative Callback-URL, die Meta für die Weiterleitung der Nachrichten-Webhooks einer WhatsApp-Nummer an andere Ziele akzeptiert.

Wie funktioniert ein Verbindungslink?

Ähnlich wie eine Checkout-Seite. Ihr Backend erstellt eine Sitzung, Ihre Oberfläche schickt den Kunden zu deren URL, der Kunde verbindet sich auf einer Seite unter easycoexistence.com, und der Browser kehrt zu Ihrer redirect_url zurück. Ihr Backend bestätigt dann das Ergebnis und ruft die Zugangsdaten der neuen Verbindung ab, alles mit Ihrem API-Schlüssel.

1CreatePOST /connect-sessions from your backend
2SendA redirect or a new tab to the session's url
3ConnectMeta's Embedded Signup, or the network's own sign-in
4ReturnYour redirect_url, with the session, status and new id
5ConfirmGET /connect-sessions/:id, then the credentials

Was gehört in die Anfrage?

Ein JSON-Body, der an https://easycoexistence.com/api/v1/connect-sessions gesendet wird, mit Ihrem API-Schlüssel als Bearer-Token. Nur redirect_url ist erforderlich:

  • redirect_url: eine https-URL, auf der der Kunde danach landet.
  • channel: whatsapp, der Standardwert, oder ein Social Network, das für Ihr Konto geöffnet ist, mit dem Namen in Kleinbuchstaben, etwa instagram, tiktok oder youtube.
  • external_ref: Ihre eigene ID für diesen Kunden, bis zu 200 Zeichen.
  • partner_name: der Name, den die gehostete Seite anzeigt, bis zu 80 Zeichen; standardmäßig der Name Ihres Kontos.
  • webhook_url mit webhook_verify_token: nur für Nummern und immer gemeinsam. Meta liefert die Nachrichten der Nummer dorthin ab dem Moment der Verbindung.
Create a session for a WhatsApp number
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "whatsapp",
    "redirect_url": "https://app.example.com/connect/return",
    "external_ref": "customer_4821",
    "partner_name": "ClinicApp",
    "webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
    "webhook_verify_token": "another-long-random-string"
  }'

Was kommt zurück?

Eine 201 mit der Sitzung. Senden Sie den Kunden zur url und bewahren Sie die id auf, die mit cs_ beginnt, um die Sitzung später abzurufen. expires_at liegt eine Stunde nach der Erstellung, und connection_id oder channel_id wird ausgefüllt, sobald der Kunde verbunden ist, je nach Kanal der Sitzung. GET /connect-sessions/:id liefert jederzeit dieselbe Struktur.

201 Created
{
  "id": "cs_…",
  "url": "https://easycoexistence.com/connect/cs_…",
  "channel": "whatsapp",
  "status": "created",
  "external_ref": "customer_4821",
  "connection_id": null,
  "channel_id": null,
  "token_ready": false,
  "redirect_url": "https://app.example.com/connect/return",
  "webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
  "last_error": null,
  "expires_at": "2026-10-31T15:00:00.000Z",
  "opened_at": null,
  "finished_at": null,
  "created_at": "2026-10-31T14:00:00.000Z"
}

Welche Fehler kann das Erstellen einer Sitzung zurückgeben?

Jeder Fehler hat denselben Aufbau, ein Objekt mit einem code und einer message, und die message sagt, was zu korrigieren ist. Das Erstellen einer Sitzung kann folgende Fehler zurückgeben:

  • 400 invalid_json oder invalid_request: der Body ist kein JSON-Objekt, oder ein Feld hat die Validierung nicht bestanden, etwa eine redirect_url, die nicht https ist.
  • 400 channel_unavailable: der Kanal ist für dieses Konto nicht geöffnet; die message nennt die geöffneten.
  • 401 unauthorized: der API-Schlüssel fehlt oder ist ungültig.
  • 402 billing_required: für das Konto ist noch keine Karte hinterlegt, und alles, was darüber verbunden wird, wird ihm berechnet.
  • 429 cap_reached: bereits 50 Sitzungen sind offen; warten Sie, bis einige abgeschlossen sind oder ablaufen.
  • 429 rate_limited: mehr als 100 Sitzungen in dieser Stunde; die message nennt, wie lange Sie warten müssen.

Wo landet der Kunde danach?

Auf Ihrer redirect_url, mit dem Ergebnis im Query-String. Dasselbe Ergebnis steht auf der Sitzung, die Ihr Backend mit GET /connect-sessions/:id abruft:

  • session: die Sitzungs-ID, cs_ gefolgt von zufälligen Zeichen.
  • status: connected, oder cancelled, wenn der Kunde Abbrechen und zurückgehen gewählt hat.
  • external_ref: Ihre ID für den Kunden, sofern die Sitzung eine enthielt.
  • connection_id: die ID der neuen Nummer, für /connections.
  • channel_id: die ID des neuen Social-Media-Kontos, für /channels.
A number connected
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…

Welche Status kann eine Sitzung haben?

Fünf. GET /connect-sessions/:id gibt den aktuellen Status an, mit opened_at, finished_at und last_error, das angibt, warum der letzte Versuch fehlgeschlagen ist:

  • created: von Ihrem Backend erstellt, noch nicht geöffnet.
  • opened: der Kunde hat die gehostete Seite geladen.
  • connected: eine Nummer oder ein Social-Media-Konto wurde verbunden, und seine ID steht auf der Sitzung.
  • cancelled: der Kunde ist über Abbrechen und zurückgehen gegangen.
  • expired: die Stunde ist abgelaufen, bevor die Sitzung abgeschlossen war.

Wie lange ist ein Link gültig?

Eine Stunde ab Erstellung. Danach teilt die gehostete Seite dem Kunden mit, dass der Link abgelaufen ist, mit einer Schaltfläche zurück zu Ihrer redirect_url mit status=cancelled, und die Sitzung zeigt expired an. Ein Konto kann 50 offene Sitzungen halten und 100 pro Stunde erstellen, weil Meta jede Erstregistrierung auf ein app-weites Limit anrechnet, das sich alle Konten teilen.

Was bewirkt external_ref?

Es ordnet jede Verbindung Ihrem Kunden zu. Der übermittelte Wert wird auf der Nummer oder dem Kanal gespeichert, die die Sitzung erstellt, in die Weiterleitung aufgenommen und in jedes Statusereignis dazu übernommen, sodass GET /connections?external_ref=customer_4821 und GET /channels?external_ref=customer_4821 auflisten, was dieser Kunde verbunden hat. Eine Anmeldung bei Facebook oder LinkedIn kann gleich mehrere Seiten übertragen: die Weiterleitung nennt die erste, der Filter listet die übrigen. Verwenden Sie eine stabile ID aus Ihrer eigenen Datenbank, keine E-Mail-Adresse, die sich ändern kann.

Was passiert, wenn der Kunde abbricht oder eine Anmeldung fehlschlägt?

Das hängt davon ab, wo es passiert ist; die Sitzung hält den Verlauf fest:

  • Das Popup von Meta schlägt fehl oder wird geschlossen: der Kunde drückt auf derselben Seite erneut Verbinden, solange der Link offen ist.
  • Eine Social-Media-Anmeldung wird abgebrochen oder abgelehnt: der Kunde kehrt mit dem Grund zur gehosteten Seite zurück und kann es erneut versuchen, bis der Link abläuft.
  • Das Konto ist bereits über ein anderes easyCoexistence-Konto verbunden: last_error sagt das, und der Kunde meldet sich mit einem anderen Konto an.
  • Der Kunde wählt Abbrechen und zurückgehen: Ihre redirect_url erhält status=cancelled, und die Sitzung wird geschlossen; erstellen Sie für einen weiteren Versuch eine neue.
  • Der Link ist abgelaufen: erstellen Sie eine neue Sitzung.

Was ist, wenn eine Nummer ohne das Token des Kunden verbunden wird?

Meta schließt das Embedded Signup manchmal ab, ohne das eigene Business-Token des Kunden auszustellen. Die gehostete Seite fordert dann einen weiteren Durchlauf an, der einige Sekunden dauert. Überspringt der Kunde ihn, zeigt die Sitzung connected mit token_ready false, und Ihre Ereignis-URL erhält connection.token_missing: Die Nummer empfängt Nachrichten, da ihre IDs gültig sind, kann aber erst senden, wenn eine neue Verbindungssitzung sie erneut verbindet und das Token ausstellt.

Was passiert, wenn die webhook_url Metas Prüfung nicht besteht?

Die Nummer wird trotzdem verbunden. Meta prüft eine webhook_url mit einem GET-Handshake, den Ihr Endpoint besteht, indem er hub.challenge zurückgibt, sobald hub.verify_token übereinstimmt. Schlägt die Prüfung fehl, beginnt last_error der Sitzung mit webhook_url was not applied und nennt den Grund von Meta, und PUT /connections/:id/webhook setzt das Ziel, sobald der Endpoint antwortet. Wird es innerhalb von 24 Stunden nach der Verbindung gesetzt, erhält es trotzdem den einmaligen Import der Kontakte und, sofern der Kunde zugestimmt hat, den Chatverlauf.

Was sieht der Kunde?

Eine Seite auf easycoexistence.com mit Ihrem Namen aus partner_name, und kein Konto, keine E-Mail-Adresse und keine Karte zum Ausfüllen. Bei einer WhatsApp-Nummer zeigt sie eine kurze Checkliste zur Berechtigung, dann das Popup von Meta und einen QR-Code zum Scannen mit der WhatsApp-Business-App. Bei einem Social-Media-Konto zeigt sie eine einzige Schaltfläche, etwa Mit TikTok fortfahren, die den Zustimmungsbildschirm des Netzwerks im selben Tab öffnet, sodass es auch auf dem Handy funktioniert.

Häufige Fehler

  • Dem Query-String allein vertrauen. Jeder kann status=connected in eine URL eintippen; bestätigen Sie deshalb mit GET /connect-sessions/:id von Ihrem Backend, bevor Sie den Kunden als verbunden markieren.
  • Den Link in ein iframe einbetten. Senden Sie den Kunden per Weiterleitung oder in einem neuen Tab dorthin, denn so sind die gehostete Seite und die von ihr geöffneten Anmeldungen gedacht.
  • Links im Voraus erstellen. Jeder gilt eine Stunde, und jeder offene zählt auf das Limit von 50; erstellen Sie die Sitzung also, wenn der Kunde sich gleich verbinden wird.
  • Eine webhook_url mit mehr als 200 Zeichen senden. Meta akzeptiert alternative Callback-URLs mit bis zu 200 Zeichen; eine längere wird nicht angewendet, und die Nummer verbindet sich ohne sie.
Mit EasyCoexistence

easyCoexistence verbindet die WhatsApp-Nummern Ihrer Kunden sowie deren Instagram-, Facebook-, TikTok-, YouTube- und LinkedIn-Konten und weitere Kanäle über einen gehosteten Link mit Ihrer Software und liefert Ihrem Backend danach die Zugangsdaten, Webhooks und signierten Statusereignisse jeder Verbindung. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit den ersten 3 Tagen als kostenlose Testphase.

Häufig gestellte Fragen

Kann ein Verbindungslink zweimal verwendet werden?

Nein. Ein Link wird mit einer Nummer oder mit einer Social-Media-Anmeldung abgeschlossen, die bei Facebook oder LinkedIn mehrere Seiten übertragen kann. Danach zeigt er connected an; erstellen Sie für die nächste Verbindung eine neue Sitzung.

Kann ich den Link per E-Mail oder Chat senden?

Ja, solange der Kunde ihn innerhalb der Stunde öffnet. Die Sitzungs-ID in der URL autorisiert die Seite, senden Sie jeden Link deshalb nur an den Kunden, für den er erstellt wurde.

Funktioniert die gehostete Seite auf dem Handy?

Social-Media-Anmeldungen ja, da sie im selben Tab geöffnet werden. Eine WhatsApp-Nummer verbindet man am besten vom Computer aus: Auf dem Handy öffnet sich das Popup von Meta als neuer Tab, und zum Scannen des QR-Codes wird das Handy selbst benötigt.

Wie erfahre ich, dass ein Kunde sich verbunden hat, ohne abzufragen?

Legen Sie im Dashboard unter Profil, Entwickler eine URL für Statusereignisse fest. easyCoexistence sendet dann connection.connected oder channel.connected, signiert und mit Ihrer external_ref, sobald die Verbindung hergestellt ist.

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