AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

So bauen Sie ein KI-Agenten-Produkt auf den WhatsApp-, Instagram- und TikTok-Kanälen Ihrer Kunden

Ein KI-Agenten-Produkt auf den Kanälen der Kunden stützt sich auf drei Bausteine: einen gehosteten Verbindungslink für die WhatsApp-Nummer oder das Social-Media-Konto jedes Kunden, Webhooks, die deren Nachrichten und Kommentare an Ihr Backend liefern, wo Ihr eigenes Modell Antworten schreibt, die über die offizielle API jedes Netzwerks mit dem Token des Kunden gesendet werden, sowie Status-Ereignisse für Verbindungen, die abbrechen. Der Agent hält die Regeln jedes Netzwerks ein, etwa das 24-Stunden-Fenster von WhatsApp.

easyCoexistence gibt den KI-Agenten Ihres Produkts eine Stimme auf den WhatsApp-Nummern Ihrer Kunden sowie auf ihren Instagram-, Facebook-, TikTok-, YouTube- und LinkedIn-Konten und weiteren Kanälen: gehostete Verbindungslinks, frische Zugangsdaten, Webhooks und signierte Status-Ereignisse über die offizielle API jedes Netzwerks, wobei jede Verbindung rund um die Uhr überwacht wird.

24 hours

Das Kundenservice-Fenster von WhatsApp beginnt nach der Nachricht oder dem Anruf eines Nutzers; jede neue Nachricht setzt es zurück.

Templates only

Was ein WhatsApp-Business nach Schließen des Kundenservice-Fensters senden kann: vorab genehmigte Template-Nachrichten.

Section 4.7

Metas Bedingungen untersagen KI-Anbietern, WhatsApp zu nutzen, um KI als primäre statt nur nebensächlicher Funktion anzubieten.

7 days

Zeitfenster für die einzige private Antwort auf einen Kommentar eines Instagram-Kontos, gerechnet ab dem Zeitpunkt des Kommentars.

20 mps

Feste Durchsatzrate einer Nummer, die sowohl mit der WhatsApp-Business-App als auch mit der Cloud API genutzt wird.

Was braucht ein KI-Agenten-Produkt von dem Kanal jedes Kunden?

Vier Dinge: eine Möglichkeit für den Kunden, ihn zu verbinden, den Eingang seiner Nachrichten in Ihrem Backend, ein Token zum Antworten und Bescheid, wenn die Verbindung nicht mehr funktioniert. Die Partner API deckt jeden dieser Punkte ab, während Modell, Prompts und Gesprächslogik bei Ihnen bleiben. easyCoexistence verbindet das Konto, hält den Zugriff erneuert und überwacht ihn, und Ihre Antworten gehen von Ihrem Backend direkt an die API des Netzwerks.

1ConnectA hosted link per customer: POST /connect-sessions
2ReceiveMessages from Meta; comments and DMs forwarded, signed
3DecideYour model, your prompts, your memory
4ReplyThe network's API, with the customer's token
5Watchconnection.* and channel.* status events

Wie verbindet sich jeder Kunde?

Ihr Backend legt mit POST /connect-sessions eine Verbindungssitzung an und nennt dabei den Kanal, eine redirect_url und eine external_ref für Ihren Kunden, bei einer Nummer außerdem webhook_url und webhook_verify_token. Der Kunde öffnet den gehosteten Link, meldet sich bei Meta, TikTok, Google oder LinkedIn an und kehrt mit connection_id oder channel_id zu Ihrer App zurück. Er braucht kein easyCoexistence-Konto, keine E-Mail-Adresse und keine Karte, und jede Verbindung, die über Ihren Schlüssel entsteht, gehört zu Ihrem Konto.

Wie gelangen Nachrichten und Kommentare zu Ihrem Modell?

Per Webhook, bei den Netzwerken, die sie senden. Meta liefert die Nachrichten einer Nummer direkt an deren webhook_url, und was die Mitarbeitenden des Unternehmens aus der WhatsApp-Business-App senden, kommt dort als smb_message_echoes an. Kommentare, Erwähnungen und DMs von Instagram und Facebook sowie TikTok-Kommentare werden an das Ziel jedes Kanals weitergeleitet, signiert mit dessen Secret. YouTube und LinkedIn senden keine Kommentar-Ereignisse, daher liest der Agent neue Kommentare nach Zeitplan über deren APIs. Beantworten Sie jede Zustellung sofort mit 2xx und lassen Sie einen Worker das Modell aufrufen.

Wie antwortet der Agent?

Über die API des jeweiligen Netzwerks, mit den Zugangsdaten, die Ihr Backend abgerufen hat. Eine WhatsApp-Antwort ist ein POST an den send_endpoint der Nummer mit dem Token des Kunden; eine DM auf Instagram oder Facebook geht an die messages-Edge des Kontos; eine TikTok-Antwort wird unter dem Kommentar über business/comment/reply/create/ gesendet. Die Skizze unten beantwortet WhatsApp-Nachrichten: Sie prüft das Secret im URL-Pfad, reiht jede eingehende Nachricht ein und antwortet mit dem, was Ihr Modell zurückgibt.

Python: a WhatsApp agent on your own model
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request

EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"}  # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"]  # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {}  # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)

@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
    if not hmac.compare_digest(secret, PATH_SECRET):
        abort(404)
    if request.method == "GET":  # Meta's handshake when the destination is set
        if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
            abort(403)
        return request.args.get("hub.challenge", "")
    for entry in request.get_json().get("entry", []):
        for change in entry.get("changes", []):
            if change.get("field") == "messages":  # echoes and history are context, not prompts
                value = change["value"]
                for msg in value.get("messages", []):
                    jobs.put((value["metadata"]["phone_number_id"], msg))
    return "", 200  # answer at once; dedupe on msg["id"], since Meta can deliver twice

def worker() -> None:
    while True:
        phone_number_id, msg = jobs.get()
        conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
                            headers=KEY, params={"credentials": 1}).json()
        creds = conn["credentials"]
        if not creds["access_token"]:  # token_ready is false: a new connect session issues one
            continue
        reply = my_model(conn["external_ref"], msg)  # your model, your prompt, your memory
        requests.post(creds["send_endpoint"],  # a reply to a fresh message is inside the 24 hours
                      headers={"Authorization": f"Bearer {creds['access_token']}"},
                      json={"messaging_product": "whatsapp", "to": msg["from"],
                            "type": "text", "text": {"body": reply}})

threading.Thread(target=worker, daemon=True).start()

MCP-Server oder Partner API: welche nutzt der Agent?

Die Partner API, wenn der Agent Ihr Produkt ist und Ihre Kunden die Kanäle mitbringen: Ihr Backend hält den Schlüssel, empfängt Ereignisse und betreibt jedes Modell Ihrer Wahl. Der MCP-Server unter https://easycoexistence.com/api/mcp eignet sich für einen Assistenten wie Claude oder ChatGPT, der über Ihr eigenes easyCoexistence-Konto handelt, durch Tools, die er auf Anfrage nach einer OAuth-Anmeldung aufruft. Mit Ihrem Schlüssel verbundene Nummern und Kanäle liegen ebenfalls auf diesem Konto, sodass eine MCP-Sitzung für die Arbeit Ihres eigenen Teams darauf zugreifen kann.

Partner APIMCP server
Built forYour product, serving your customersAn assistant working on your own account
Signs in withAn ec_live_ key, one per accountOAuth, from Claude, ChatGPT or another client
Incoming messagesWebhooks to your backendRead when the assistant calls a tool
The modelAny model you runThe assistant's own
RepliesYour code calls each network's APITools such as send_message and reply_to_comment

Wie betreiben Agenturen Agenten für viele Kunden?

Auf einem Konto, wobei jeder Kunde gekennzeichnet wird. Übergeben Sie die ID des Kunden als external_ref bei jeder Verbindungssitzung, zeigen Sie den Namen Ihrer Agentur auf der gehosteten Seite mit partner_name und listen Sie die Verbindungen eines einzelnen Kunden mit GET /connections?external_ref= und GET /channels?external_ref= auf. Jede Verbindung wird der Agentur mit von US$ 9 bis US$ 0.75 pro Verbindung und Monat berechnet, sinkend mit jeder weiteren Verbindung, während Meta die WhatsApp-Gesprächsgebühren dem eigenen WhatsApp-Business-Account des Kunden belastet. Mit Coexistence beantworten die Mitarbeitenden des Kunden weiterhin in der WhatsApp-Business-App, neben dem Agenten.

An welche Regeln muss sich der Agent halten?

An die eigenen Regeln der Netzwerke, die Ihr Code prüfen sollte, bevor die Antwort des Modells hinausgeht. Die Plattformen halten sie im Namen ihrer Kunden ein, da Metas Durchsetzung das Konto des Kunden trifft:

  • WhatsApp: Freitext-Antworten nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden; danach ein genehmigtes Template, über die API gesendet, weil die WhatsApp-Business-App in Coexistence keine Templates senden kann.
  • WhatsApp: Metas Bedingungen untersagen es, KI als primäre Funktion anzubieten, was die Referenz der Partner API als keine KI-Bots für allgemeine Zwecke fasst, und erlauben Fine-Tuning auf WhatsApp-Daten nur zur ausschließlichen Nutzung durch das Unternehmen.
  • Instagram und Facebook: DMs innerhalb von 24 Stunden nach der letzten Nachricht der Person und eine private Antwort pro Kommentar innerhalb von 7 Tagen danach.
  • TikTok: Antworten auf Kommentare sind öffentlich, da eine TikTok-Verbindung keine DMs hat.
  • Volumen: 20 Nachrichten pro Sekunde pro Coexistence-Nummer, und Marketing-Templates benötigen eine Zahlungsmethode im WhatsApp-Business-Account des Kunden.

Wie erkennt der Agent, dass ein Kanal nicht mehr funktioniert?

An den Status-Ereignissen. connection.disconnected oder channel.disconnected bedeutet, dass Antworten fehlschlagen, bis sich der Kunde neu verbindet. Pausieren Sie also den Agenten dieses Kunden, informieren Sie ihn und senden Sie einen neuen Verbindungslink. connection.token_missing bedeutet, dass die Nummer empfangen, aber noch nicht senden kann. Sobald connection.connected oder channel.connected erneut eintrifft, rufen Sie frische Zugangsdaten ab und nehmen den Betrieb wieder auf. Jedes Ereignis ist mit X-EC-Signature signiert und wird etwa 33 Stunden lang erneut versucht.

Häufige Fehler

  • Das Modell beantwortet eine WhatsApp-Nachricht, die älter als 24 Stunden ist, mit Freitext. Das Fenster ist geschlossen; prüfen Sie daher den Zeitpunkt der letzten eingehenden Nachricht des Kunden und wechseln Sie auf ein genehmigtes Template.
  • Ein gemeinsames Modell auf WhatsApp-Gesprächen von Kunden zu trainieren. Metas Bedingungen erlauben Fine-Tuning auf Daten der WhatsApp Business Platform nur zur ausschließlichen Nutzung durch das Unternehmen, niemals zur Verbesserung anderer Modelle.
  • smb_message_echoes als Kundennachrichten zu behandeln. Das sind Nachrichten, die die Mitarbeitenden des Unternehmens aus der App gesendet haben. Geben Sie sie dem Modell als Kontext, nicht als Nachrichten, auf die geantwortet werden muss.
  • Die eigenen Antworten des Kontos zu beantworten. Gesendete Instagram-DMs kommen als Echos zurück und TikTok-Antworten als Kommentar-Ereignisse, also überspringen Sie alles, was das Konto selbst geschrieben hat, sonst antwortet der Agent sich selbst.
Mit EasyCoexistence

Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung. Die ersten 3 Tage sind eine kostenlose Testphase.

Häufig gestellte Fragen

Kann ich mein eigenes KI-Modell verwenden?

Ja. Ihr Backend empfängt die Nachrichten, ruft ein Modell Ihrer Wahl auf und antwortet über die API des Netzwerks mit dem Token des Kunden. Die Nachrichten einer WhatsApp-Nummer gehen von Meta direkt an Ihren Webhook, nie über easyCoexistence.

Was bedeutet Metas KI-Richtlinie für einen WhatsApp-Agenten?

Metas Bedingungen untersagen KI-Anbietern, die WhatsApp Business Platform zu nutzen, um KI-Technologie als primäre statt nur nebensächlicher oder ergänzender Funktion anzubieten, wie Meta es festlegt. Halten Sie sich im Namen Ihrer Kunden daran, ebenso an das 24-Stunden-Fenster und genehmigte Templates.

Kann der Agent auf TikTok, YouTube oder LinkedIn DMs senden?

Nein. Auf diesen Netzwerken arbeitet der Agent in den Kommentaren: TikTok-Antworten sind öffentlich, YouTube- und LinkedIn-Kommentare werden über deren APIs gelesen und beantwortet.

Was kostet easyCoexistence für ein KI-Agenten-Produkt?

Pro Verbindung, auf jedem Netzwerk gleich: von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung. Die ersten 3 Tage sind kostenlos. Meta stellt die WhatsApp-Gesprächsgebühren dem eigenen WhatsApp-Business-Account jedes Kunden in Rechnung.

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