Bringen Sie Ihren eigenen KI-Agenten zu WhatsApp: jedes Framework (LangGraph, ADK, eigener Code) per Webhook-Endpunkt anbinden

Sie können fast jeden KI-Agenten mit WhatsApp verbinden, ohne ihn neu zu schreiben. Betreiben Sie Ihren Agenten, gebaut mit LangGraph, Google ADK, CrewAI oder eigenem Code, hinter einem HTTPS-Endpunkt und fügen Sie ihn in MonoChat als KI-Harness mit dem Anbieter Custom hinzu: eine Endpunkt-URL und ein gemeinsames Secret. Setzen Sie einen KI-Agent-Node in einen Flow, verbinden Sie Ihre WhatsApp-Nummer, und Ihr Agent beantwortet Kunden auf WhatsApp und jedem anderen Kanal, den MonoChat anbindet, mit gemeinsamem Posteingang und Übergabe an Menschen drumherum.

Dieser Leitfaden richtet sich an Teams, die bereits einen Agenten haben oder volle Kontrolle darüber wollen, wie er arbeitet. Er behandelt, wann es sinnvoll ist, den eigenen Agenten mitzubringen, wofür Ihr Endpunkt zuständig ist, die Einrichtung in MonoChat und die Details, die im Produktivbetrieb zählen.

Warum den eigenen Agenten mitbringen?

Die meisten Kundenmessaging-Plattformen bringen einen integrierten KI-Agenten mit. Das ist bequem, bis:

• Ihr Agent schon gebaut ist. Ihre Entwickler haben Monate in einen LangGraph-Graphen oder ein ADK-Multi-Agent-Setup gesteckt, mit Evaluierungen und Tests. Ihn im Bot-Builder eines Anbieters neu zu bauen, wirft diese Arbeit weg.
• Sie eigene Logik brauchen. Preisregeln, Berechtigungsprüfungen, Compliance-Schritte oder interne Systeme, die nur Ihr Code erreichen kann.
• Sie das Framework selbst wählen wollen. Frameworks entwickeln sich schnell. Heute ist es LangGraph, nächstes Jahr vielleicht etwas anderes. Ihre Kanäle und Ihr Posteingang sollten sich dadurch nicht ändern müssen.
• Daten bei Ihnen bleiben müssen. Manche Organisationen wollen, dass das Reasoning und die Tool-Aufrufe des Agenten auf der eigenen Infrastruktur laufen.

Das Agent Harness von MonoChat ist dafür gebaut: Bringen Sie Ihr eigenes Agent-Framework mit und behalten Sie alles drumherum, die Kanäle, den Posteingang, die Menschen, an einem Ort.

So funktioniert das Custom Harness

Stellen Sie es sich als Arbeitsteilung vor.

MonoChat übernimmt die Unterhaltungsebene:

• Die offiziellen Anbindungen an WhatsApp, Instagram, Messenger, TikTok, Telegram, Web-Chat, SMS und Voice (MonoChat ist ein offizieller Meta Business Partner).
• Den Flow, der über den KI-Agent-Node entscheidet, wann der Agent aufgerufen wird.
• Den gemeinsamen Team-Posteingang, in dem eine Person mit vollständigem Verlauf übernehmen kann.

Ihr Endpunkt übernimmt den Agenten:

• Die Unterhaltung von MonoChat entgegennehmen.
• Ihren Agenten ausführen: sein Reasoning, seine Tools, sein Gedächtnis.
• Die Antwort des Agenten zurückgeben.

Dazwischen steht ein gemeinsames Secret, ein Wert, den beide Seiten kennen, damit Ihr Endpunkt prüfen kann, dass eine Anfrage von Ihrem MonoChat Konto kommt. MonoChat legt das genaue Anfrage- und Antwortformat fest, das Ihr Endpunkt umsetzt; falls Sie es noch nicht haben, sprechen Sie uns an, und wir geben es an Ihre Entwickler weiter.

Was Ihr Endpunkt leisten sollte

Unabhängig vom Framework hat ein produktionsreifer Agent-Endpunkt einige Aufgaben.

Jede Anfrage verifizieren

Prüfen Sie bei jedem Aufruf das gemeinsame Secret und lehnen Sie alles ab, was nicht passt. Speichern Sie das Secret in Ihrem Secrets-Manager oder in Umgebungsvariablen, nicht im Code, und tauschen Sie es aus, falls es jemals offengelegt wird.

Jede Unterhaltung getrennt halten

Kunden schreiben parallel. Stellen Sie sicher, dass Zustand, Gedächtnis und etwaige Arbeitsdateien Ihres Agenten auf eine Unterhaltung begrenzt sind, damit die Daten eines Kunden nie in die Antwort eines anderen gelangen.

In chatgerechten Nachrichten antworten

Für Web-Apps gebaute Agenten neigen zu langen, formatierten Antworten. WhatsApp wird auf dem Smartphone gelesen. Bitten Sie Ihren Agenten um kurze Nachrichten, jeweils eine Frage, und halten Sie aufwendiges Markdown aus den Antworten heraus.

Laut scheitern, nicht still

Wenn ein Tool in ein Timeout läuft oder Ihr Modellanbieter einen Fehler zurückgibt, geben Sie einen klaren Fehler zurück statt einer halbfertigen Antwort. Ein vorhersehbarer Fehler lässt den Flow das Richtige tun, zum Beispiel die Unterhaltung an eine Person übergeben.

Schnell sein

Kunden erwarten eine Antwort innerhalb von Sekunden. Halten Sie langlaufende Arbeit, wo möglich, aus dem Antwortpfad heraus und machen Sie Ihre Tools schnell oder asynchron.

Schritt für Schritt in MonoChat

1. Ihren Agenten hinter HTTPS bereitstellen

Hosten Sie Ihren LangGraph-, ADK-, CrewAI- oder eigenen Agenten auf Ihrem eigenen Server oder in Ihrer Cloud, erreichbar über HTTPS. Setzen Sie das Anfrage- und Antwortformat von MonoChat und die Prüfung des gemeinsamen Secrets um.

2. Ein KI-Harness mit dem Anbieter Custom hinzufügen

Fügen Sie in MonoChat ein KI-Harness hinzu, wählen Sie Custom und geben Sie Ihre Endpunkt-URL und das gemeinsame Secret ein. Sie fügen das Harness einmal hinzu und können es in beliebig vielen Flows nutzen.

3. Einen KI-Agent-Node in einen Flow setzen

Fügen Sie in dem Flow, der eingehende Unterhaltungen empfängt, einen KI-Agent-Node hinzu und wählen Sie Ihr Custom Harness. Nutzen Sie den Flow drumherum für das, was Flows am besten können: Begrüßung, Routing nach Sprache oder Thema, Geschäftszeiten und der Weg zu einer Person.

4. Ein Budget pro Durchlauf festlegen

Jeder KI-Agent-Node unterstützt Budgetlimits pro Durchlauf. Nutzen Sie sie als Sicherheitsnetz neben den Limits, die Sie bereits in Ihrem eigenen Code durchsetzen.

5. WhatsApp und andere Kanäle verbinden

Verbinden Sie Ihre WhatsApp Business Nummer und hängen Sie denselben Flow dann an die anderen Kanäle, die Sie nutzen. Pro Kanal fällt keine zusätzliche Integrationsarbeit an: Ihr Endpunkt sieht Unterhaltungen, keine Kanal-APIs.

6. Testen, dann live gehen

Spielen Sie echte Kundennachrichten durch den Flow. Prüfen Sie Tool-Aufrufe, Antwortzeiten, Ton und Übergabe. Beobachten Sie die ersten Tage mit Live-Traffic genau und erweitern Sie dann, was der Agent tun darf.

Hinweise zu den Frameworks

LangGraph. Ein Graph aus Knoten und Kanten passt natürlich zu Support-Abläufen (Triage, Nachschlagen, Lösen, Eskalieren). Verpacken Sie den kompilierten Graphen in einen kleinen HTTP-Dienst, laden Sie bei jeder Anfrage den Zustand der Unterhaltung und geben Sie die endgültige Nachricht zurück.

Google ADK. Die Multi-Agent-Bäume von ADK, ein Koordinator mit spezialisierten Sub-Agenten, passen gut zu Support-, Vertriebs- und Abrechnungsteams. Stellen Sie den Root-Agenten über Ihren Endpunkt bereit und lassen Sie ADK intern routen.

CrewAI. Crews rollenbasierter Agenten funktionieren gut bei Aufgaben mit klaren Übergaben, etwa erst recherchieren, dann antworten. Halten Sie Crews für den Chat klein: Jeder zusätzliche Agent erhöht die Latenz.

Ihr eigener Code. Eine einfache Schleife mit einer Modell-API und ein paar Funktionen genügt oft. Sie behalten die volle Kontrolle, und MonoChat liefert die Kanäle und den Posteingang.

Übergabe: im Flow entscheiden

Entscheiden Sie im Flow, welche Unterhaltungen an eine Person gehen und welches Team sie erhält, und schreiben Sie Ihren Agenten so, dass er dem Kunden ehrlich sagt, wenn er nicht helfen kann, statt zu raten. Der Flow übergibt die Unterhaltung dann mit vollständigem Verlauf an das richtige Team im gemeinsamen Posteingang. Die Business Messaging Policy von WhatsApp erwartet außerdem, dass automatisierte Antworten einen klaren Weg zu einem Menschen bieten.

Halten Sie Ihren Agenten auch im Rahmen Ihres Unternehmens. Seit dem 15. Januar 2026 hält WhatsApp universelle KI-Assistenten von der Plattform fern; Agenten, die Ihre eigenen Kunden betreuen, sind in Ordnung. Unser Leitfaden zur WhatsApp KI-Chatbot-Richtlinie erklärt die Regel.

Wann Sie keinen eigenen bauen sollten

Ein eigener Agent ist die flexibelste Option und zugleich die, die Sie selbst warten. Wenn Sie bei null anfangen, bringt Sie eine integrierte Option schneller live, ohne dass Sie etwas hosten müssen:

• Das integrierte Harness von MonoChat auf Ihren MonoChat KI-Modellen.
• Das OpenAI Agents SDK, betrieben in MonoChat (Leitfaden).
• Das Claude Agent SDK oder Pi, betrieben auf dem Agent Runner von MonoChat (Claude-Leitfaden).
• Gehostete Agenten: die OpenAI Agents API oder Claude Managed Agents, mit Ihrem eigenen Schlüssel.

Da jede Option denselben KI-Agent-Node nutzt, können Sie mit einer beginnen und später zu Ihrem eigenen Agenten wechseln, ohne Ihre Kanäle oder die Übergabe anzufassen. Vergleichen Sie sie auf der Agent Harness Seite.