Multi-Tenant-Social-Media-API: ein API-Schlüssel, viele Kundenkonten
Die Partner API von easyCoexistence ist von Grund auf multi-tenant: Ein ec_live_-Schlüssel auf Ihrem Konto verbindet und verwaltet die WhatsApp-Nummern und Social-Media-Konten vieler Kunden. Jede Verbindung trägt die ID Ihres Kunden als external_ref, hält das eigene Token dieses Kunden, besitzt ein eigenes Webhook-Ziel und erscheint in signierten Status-Events. So listet GET /channels?external_ref= die Konten eines einzelnen Kunden auf.
Maximale Länge der external_ref, die eine Verbindungssitzung annimmt: Ihre eigene ID für den Kunden, gespeichert auf der Verbindung, die sie anlegt.
API-Schlüssel, die ein easyCoexistence-Konto gleichzeitig hält; getrennte Schlüssel bedeuten getrennte Konten mit getrennter Abrechnung.
Verbindungssitzungen, die ein Konto gleichzeitig offen halten darf, neben einem Limit von 100 neuen Sitzungen pro Stunde.
Alter, nach dem der Zeitstempel eines signierten Events abgelehnt werden sollte, wobei der HMAC in konstanter Zeit verglichen wird.
Wie bedient ein Konto viele Kunden?
Ihr easyCoexistence-Konto steht für Ihr Produkt, und jeder Kunde ist eine Kennzeichnung auf den Verbindungen, die er mitbringt. Kunden legen kein eigenes Konto an, sehen Ihren Schlüssel nie und werden von Ihnen abgerechnet, nicht von easyCoexistence:
Wie kennzeichnen Sie jede Verbindung mit Ihrem Kunden?
Senden Sie external_ref bei der Verbindungssitzung. Der Wert wird auf der Nummer oder dem Kanal gespeichert, die bzw. den die Sitzung anlegt, in die Weiterleitung aufgenommen und in deren Status-Events mitgeliefert. Eine Facebook- oder LinkedIn-Anmeldung, die mehrere Seiten einbringt, kennzeichnet jede einzeln. Um die Konten eines Kunden zu sehen, filtern Sie eine der beiden Listen:
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"Wie werden die Token der Kunden getrennt gehalten?
Jede Verbindung hält das Token ihres eigenen Kunden. Das Token einer WhatsApp-Nummer stellt Meta bei Embedded Signup aus; es ist auf die Assets dieses Kunden beschränkt. Das Token eines Social-Media-Kontos ist das, das sein Inhaber gewährt hat. Zugangsdaten kommen nur über Ihren Schlüssel und aus Ihrem Backend. Eine ID, die nicht zu Ihrem Konto gehört, antwortet mit 404 not_found. Suchen Sie die Verbindung des Kunden, zu dem ein Auftrag gehört, bevor Sie dessen Token abrufen, damit die Arbeit eines Mandanten nie auf dem Konto eines anderen läuft.
Wie funktionieren Webhooks pro Kunde?
Ein Webhook-Ziel pro Konto, von Ihnen gewählt. Richten Sie die Kanäle auf eine URL aus und leiten Sie anhand von account_id im Body weiter, oder geben Sie jedem Kunden eine eigene URL. Jeder Kanal signiert mit seinem eigenen Signing-Secret aus PUT /channels/{id}/webhook, daher verrät die account_id, mit welchem Secret Sie prüfen müssen. Die Nachrichten einer Nummer gehen von Meta an ihre webhook_url, die am WhatsApp Business Account gesetzt wird, also leiten Sie diese anhand von phone_number_id weiter.
Wie zeigen Status-Events, welcher Kunde betroffen ist?
Indem sie Ihre external_ref mitführen. Eine Events-URL pro Konto empfängt connection.*- und channel.*-Events, jeweils mit der Verbindungs- oder Kanalansicht darin, einschließlich external_ref. post.published und post.failed tragen den Beitrag und seinen Kanal. Events werden mit dem eigenen Secret des Kontos in X-EC-Signature signiert und erneut zugestellt, wenn Ihr Endpoint ausfällt. Verarbeiten Sie daher jede Delivery-ID nur einmal.
Wie schnell lassen sich viele Kunden anbinden?
Bis zu 50 offene Verbindungssitzungen und 100 neue pro Stunde und Konto. Meta zählt jede erstmalige WhatsApp-Einrichtung gegen ein app-weites Limit, das alle easyCoexistence-Konten teilen. Die Obergrenzen verhindern, dass der Import einer Plattform es aufbraucht. Legen Sie jede Sitzung an, wenn ihr Kunde sich gerade verbinden will. Eine Obergrenze antwortet mit 429 cap_reached oder rate_limited.
Was, wenn das Konto eines Kunden bereits anderswo verbunden ist?
Die Anmeldung wird abgelehnt. Ein Social-Media-Konto verbindet sich jeweils nur über ein easyCoexistence-Konto. Hält ein anderer Dienst, der easyCoexistence nutzt, es bereits, sagt das last_error der Sitzung dies, und der Kunde entfernt es dort oder meldet sich mit einem anderen Konto an. Innerhalb Ihres eigenen Kontos kann ein Kunde so viele Konten verbinden, wie er braucht, jedes mit derselben external_ref gekennzeichnet.
Wie entfernen Sie einen Kunden vollständig?
Listen Sie seine Verbindungen und Kanäle nach external_ref auf und löschen Sie jede per DELETE. Eine Nummer zu entfernen widerruft den Zugriff von easyCoexistence bei Meta und beendet die Überwachung. Einen Kanal zu entfernen widerruft den Zugriff beim Netzwerk und storniert seine Beiträge, die noch in der Warteschlange stehen. Die Abrechnung jeder Verbindung endet zum Ende des Abrechnungszyklus. Die übrigen Verbindungen des Kunden bleiben, wie die anderer Mandanten, unberührt.
Häufige Fehler
- Eine E-Mail-Adresse als external_ref verwenden. E-Mail-Adressen ändern sich, und der Wert wird auf jeder Verbindung gespeichert. Verwenden Sie daher die stabile ID aus Ihrer eigenen Datenbank.
- Weitergeleitete Events mit dem Secret des falschen Mandanten prüfen. Suchen Sie das Secret anhand der account_id im Body, da jeder Kanal mit seinem eigenen signiert.
- Verbindungslinks an Ihren gesamten Kundenstamm auf einmal senden. Pro Konto können nur 50 Sitzungen offen sein, laden Sie Kunden daher in Wellen ein.
- Einen Kunden nur in Ihrer eigenen Datenbank löschen. Seine Verbindungen bleiben auf Ihrem Konto und in Ihrer Abrechnung, bis jede einzeln über die API entfernt wurde.
easyCoexistence lässt einen API-Schlüssel Ihren gesamten Kundenstamm bedienen: deren WhatsApp-Nummern sowie Instagram-, Facebook-, TikTok-, YouTube- und LinkedIn-Konten und weitere Kanäle, jeweils mit Ihrer Kunden-ID gekennzeichnet, mit eigenem Token, eigenem Webhook und signierten Events. Jede Verbindung wird rund um die Uhr überwacht. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit den ersten 3 Tagen kostenlos.
Häufig gestellte Fragen
Benötige ich ein eigenes easyCoexistence-Konto pro Kunde?
Nein. Ein Konto und sein Schlüssel können die Verbindungen vieler Kunden halten, unterschieden über external_ref. Getrennte Konten sind nur nötig, wenn Sie getrennte Abrechnungen wünschen.
Können meine Kunden die Konten der anderen sehen?
Nicht über easyCoexistence. Sie halten nie Ihren Schlüssel und öffnen nur ihre eigenen Verbindungslinks. Was jeder Kunde in Ihrem Produkt sieht, entscheidet Ihr Code.
Kann ich jedem Kunden eine andere Webhook-URL geben?
Ja. Jede Nummer und jeder Kanal erhält ein eigenes Ziel, daher funktioniert eine kundenspezifische URL ebenso wie eine gemeinsame URL, die anhand von account_id weiterleitet.
Wie wird ein Multi-Tenant-Konto abgerechnet?
Pro Verbindung über alle Ihre Kunden zusammen: US$ 9 bis US$ 0.75 pro Verbindung und Monat, bestimmt durch die Stufe Ihrer Gesamtzahl, mit den ersten 3 Tagen kostenlos.
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