Nachrichten an Ihren KI-Agenten weiterleiten

Bird sendet jede Nachricht, die Sie über WhatsApp, SMS, Apple Messages oder ein Agenten-Postfach empfangen, an Ihren KI-Agenten. Verbinden Sie den Agenten einmalig mit seinen Details und Anmeldedaten, und jede neue Nachricht erreicht ihn.

Zwei Agenten werden unterstützt:

Claude Managed Agents: Jede Nachricht startet eine Sitzung eines Agenten, den Sie in der Claude Console erstellt haben.
Grok Bot: Jede Nachricht aktiviert eine Ihrer Grok-Bot-Routinen.

Bird sendet jede passende Nachricht an Ihren Agenten und wiederholt eine fehlgeschlagene Zustellung, sodass eine wiederholte Nachricht einen weiteren Durchlauf starten kann. Der Agent empfängt das Ereignis JSON der Nachricht – dieselbe Nutzlast, die ein normaler Webhook-Endpunkt erhält – und antwortet über die Tools, die Sie ihm bereitgestellt haben, etwa den Bird-MCP-Server.

Wählen Sie die Nachrichten, die Ihr Agent beantwortet

Ihr Agent kann nur eingehende Nachrichten beantworten: whatsapp.received, sms.received, amb.received (Apple Messages) und email_mailbox.message_received. Wählen Sie diejenigen aus, die der Agent verarbeiten soll. Zustellbestätigungen, Statusänderungen und andere Ereignisse werden nicht an einen Agenten gesendet.

Claude Managed Agents

Richten Sie zuerst Ihren Agenten in der Claude Console ein: Erstellen Sie den Agenten und seine Umgebung sowie einen API-Schlüssel im selben Workspace. Notieren Sie die Agenten-ID und die Umgebungs-ID. Neue Sitzungen verwenden die neueste Version des Agenten.

Verbinden Sie ihn dann in Bird:

Erstellen Sie einen Webhook und wählen Sie Claude Managed Agents.
Wählen Sie unter Triggers die Nachrichten aus, die Claude beantworten soll.
Geben Sie unter Connect dem Webhook einen Namen und tragen Sie die Agent-ID, die Environment-ID und den API-Key ein.
Prüfen Sie den Webhook und erstellen Sie ihn.

Jede Nachricht startet eine Session, deren erste User-Nachricht New Bird event: ist, gefolgt vom Event JSON.

Grok Bot

Bitten Sie Grok Bot zunächst, eine Routine mit einem Webhook-Trigger zu erstellen. Sie erhalten die Webhook-URL und den Sender-Key der Routine. Um den Trigger stattdessen manuell einzurichten, siehe Cursors Webhook-Trigger.

Verbinden Sie ihn dann in Bird:

Erstellen Sie einen Webhook und wählen Sie Grok Bot.
Wählen Sie unter Triggers die Nachrichten aus, die Grok Bot beantworten soll.
Geben Sie unter Connect dem Webhook einen Namen und fügen Sie die Webhook-URL und den Sender-Key ein.
Überprüfen Sie den Webhook und erstellen Sie ihn.

Jede Nachricht sendet das Event JSON per POST an die Webhook-URL der Routine, mit dem Sender Key als Bearer-Token, und die Routine führt ihren gespeicherten Prompt aus.

Über die CLI oder API erstellen

bird webhooks create --help listet jeden Connector mit seinen Feldern auf, welche davon geheim sind, welche Events er akzeptiert und welche Einrichtung zuerst nötig ist. Übergeben Sie nicht geheime Felder mit --field name=value und jedes Geheimnis aus einer Umgebungsvariable mit --secret-env name=ENV_VAR, oder leiten Sie es mit --secret-stdin name weiter, damit es nicht in Ihrer Shell-History erscheint. --events umfasst standardmäßig jedes Nachrichten-Event, das der Connector akzeptiert.

Erstellen Sie für Claude einen API-Key im Workspace, in dem Ihr Agent läuft. Lesen Sie ihn dann ohne Ausgabe in die Umgebung ein, damit er nie in einer Kommandozeile oder Ihrer Shell-History erscheint:

Codebeispiel

read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY  # paste the key, then press Enter
bird webhooks create --connector claude_managed_agents \
  --field agent_id=agent_123 --field environment_id=env_123 \
  --secret-env api_key=ANTHROPIC_API_KEY

Die API akzeptiert denselben destination über POST /v1/webhooks. Lassen Sie url weg: Bird erstellt ihn aus dem Connector. Keine Antwort enthält die Zugangsdaten.

Verbindung testen

Wählen Sie direkt nach dem Erstellen des Webhooks Send test. Später können Sie Send test event auf der Webhook-Seite oder in den Zeilenaktionen verwenden oder POST /v1/webhooks/{webhook_id}/test aufrufen. Prüfen Sie in Claude oder Cursor, ob eine Session oder ein Run gestartet wurde. Senden Sie dann eine echte Nachricht an eine Ihrer Nummern oder Kanäle und bestätigen Sie, dass der Agent sie verarbeitet.

Betrieb

Zugangsdaten rotieren. Bearbeiten Sie den Webhook und geben Sie nur den neuen Wert ein; ein Feld, das Sie leer lassen, behält seinen gespeicherten Wert. Über die API senden Sie den geänderten Key in PATCH /v1/webhooks/{webhook_id} credentials. Die nächste Zustellung verwendet ihn, einschließlich Wiederholungen.
Auf einen anderen Agenten umstellen. Erstellen Sie einen neuen Webhook. Über eine Bearbeitung lassen sich weder Plattformen wechseln noch Einstellungen wie die Agent-ID oder die Webhook-URL ändern.
Pausieren oder entfernen. Das Pausieren eines Webhooks stoppt seine Zustellungen. Das Löschen entfernt seine Zugangsdaten.
Fehler einsehen. Die Zustellversuche eines Webhooks zeigen jede Zustellung mit dem Antwortstatus und -body der Plattform, oder keinen, wenn die Plattform nicht erreichbar war. Ein Versuch, der fehlschlug, bevor Bird etwas gesendet hat – etwa weil sich eine Verbindung nach dem Ereignis geändert hat –, enthält stattdessen eine failure_reason.

Nächste Schritte

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.

Implementierungs-Briefing erhalten

Verwandte Ressourcen