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, also 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

1. Erstellen Sie in der Claude Console einen Agenten, eine Umgebung und einen API-Schlüssel.
2. Erstellen Sie in Bird einen Webhook, wählen Sie Claude Managed Agents und wählen Sie unter Triggers die Nachrichten aus.
3. Geben Sie unter Connect die Agenten-ID, die Umgebungs-ID und den API-Schlüssel ein und erstellen Sie dann den Webhook.
4. Wählen Sie Send test.
5. (Optional) Damit der Agent über Bird antworten kann, öffnen Sie den Agenten in der Claude Console, wählen Sie + MCP Server und dann Bird. Damit sein Token-Verbrauch niedrig bleibt, aktivieren Sie nur die Bird-Tools, die er verwendet, wie unter Claude Managed Agents beschrieben.
6. (Optional) Öffnen Sie Managed Agents > Credential vaults, erstellen Sie einen Vault, wählen Sie + Add credential, setzen Sie Type auf MCP OAuth, wählen Sie Bird und dann Connect.
7. (Optional) Geben Sie die Vault-ID (sie beginnt mit vlt_) unter Connect ein, oder bearbeiten Sie einen bestehenden Webhook, um sie hinzuzufügen.

Grok Bot

1. Installieren Sie Bird in Grok Bot und verbinden Sie Ihren Bird-Workspace.
2. Bitten Sie Grok Bot, eine Routine mit einem Webhook-Trigger zu erstellen. Öffnen Sie den Abschnitt Webhook der Routine und kopieren Sie deren URL und Sender-Key.
3. Erstellen Sie den Webhook in Bird auf eine der folgenden Arten:
   • Bitten Sie Grok Bot, ihn mit einem Grok Bot-Ziel für ein Event wie amb.received oder email_mailbox.message_received zu erstellen und dabei die URL und den Sender-Key aus Schritt 2 zu verwenden. Nennen Sie bei E-Mail das Postfach.
   • Erstellen Sie ihn im Dashboard: Wählen Sie Grok Bot, wählen Sie unter Triggers das Event aus und fügen Sie unter Connect die URL und den Sender-Key ein.
4. Wählen Sie Send test und senden Sie dann eine echte Nachricht an Ihr Unternehmen oder Postfach.

Mit einer Vorlage beginnen (optional). Wählen Sie vor Schritt 2 AMB Booking Desk oder Email Support Desk und geben Sie Grok Bot dann die zugehörige Datei bot.md und shared/message-safety.md als dauerhafte Anweisungen. Füllen Sie Your settings und Knowledge aus, aktivieren Sie den Kanal-Skill der Vorlage und verwenden Sie deren Routine prompt für Schritt 2.

Antworten aus Vorlagen werden standardmäßig als Entwürfe erstellt.

Wenn kein Durchlauf startet, vergleichen Sie die Webhook-URL und den Sender-Key der Routine mit den Werten in Bird.

Über die CLI oder API erstellen

Webhook connectors listet für jeden Connector die Felder auf, welche davon geheim sind, welche Events er akzeptiert und welche Einrichtung zuerst nötig ist. bird webhooks create --connector <id> --request-schema gibt dieselben Felder als JSON Schema aus. Übergeben Sie nicht geheime Felder mit --field name=value und jedes Geheimnis mit --credential name=FILE aus einer Datei oder mit --credential name=- über stdin, 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-Schlüssel im Workspace, in dem Ihr Agent läuft. Lesen Sie ihn dann ohne Ausgabe in eine Shell-Variable ein und leiten Sie ihn per Pipe weiter, damit er nie in einer Kommandozeile oder Ihrer Shell-History erscheint:

read -rs 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 \
  --field vault_id=vlt_123 --credential api_key=- <<< "$ANTHROPIC_API_KEY"

bird webhooks connect <connector> erledigt all das in einem Schritt. Der Befehl nennt jedes Feld, das der Connector noch benötigt, erstellt den Webhook und gibt die Webhook-ID, die Events und den Postfachfilter aus, ohne Geheimnisse. Unter next nennt er bird webhooks test für den Webhook, womit die Felder bei der Plattform geprüft werden. Über MCP erledigt webhooks_create mit connector_id dasselbe in einem Aufruf, und sein next nennt den Aufruf webhooks_test.

Um die E-Mails eines Postfachs an den Agenten zu senden, ergänzen Sie --mailbox mit der ID oder Adresse des Postfachs. Eine Adresse wird nachgeschlagen, wofür der Scope mailbox:read nötig ist. Die Option setzt filter.mailbox_id, und --events umfasst dann standardmäßig die Postfach-Events, die die Aktion des Connectors auflistet, oder email_mailbox.message_received bei einer Aktion, die jedes Event akzeptiert. Ersetzen Sie für Grok Bot YOUR_MAILBOX_ADDRESS und YOUR_ROUTINE_WEBHOOK_URL durch Ihr Postfach und die Webhook-URL der Routine, und fügen Sie den Sender-Key der Routine ein, wenn read darauf wartet:

read -rs GROK_SENDER_KEY  # paste the sender key, then press Enter
bird webhooks connect grok_bot --mailbox YOUR_MAILBOX_ADDRESS \
  --field webhook_url=YOUR_ROUTINE_WEBHOOK_URL \
  --credential sender_key=- <<< "$GROK_SENDER_KEY"

Jede email_mailbox.message_received-Zustellung enthält die Nachricht unter data: data.message_id, data.mailbox_id und data.thread_id, den Absender in data.from, die Empfänger in data.to und data.subject, das null ist, wenn die Nachricht keinen hatte. data.extracted_text ist der Text ohne zitierten Verlauf, null, wenn kein Text vorhanden ist, und auf 64 KB begrenzt. data.truncated_text ist true, wenn er gekürzt wurde. Die Event-Referenz listet jedes Feld auf.

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, bird webhooks test <webhook_id> ausführen oder POST /v1/webhooks/{webhook_id}/test aufrufen. Wenn Sie einen Webhook über die CLI oder den API erstellen oder aktualisieren, nennt next diesen Schritt. Beim Speichern des Webhooks wird die Plattform nicht kontaktiert, daher prüft erst der Test seine Felder. Bei Claude Managed Agents liest der Test den Agenten, statt eine Sitzung zu starten. Damit bestätigt er den API-Schlüssel und die Agenten-ID und meldet kind: probe. Wenn die Antwort einen falschen Wert erkennen lässt, nennt field diesen Wert. Eine solche Prüfung sendet kein Event, daher ist erst die erste echte Nachricht der End-to-End-Test. Bei Grok Bot startet der Test einen Routine-Durchlauf mit einem als "test": true markierten Event. Prüfen Sie daher in Cursor, ob ein Durchlauf gestartet wurde. Senden Sie dann eine echte Nachricht an eine Ihrer Nummern oder Kanäle und prüfen Sie, ob der Agent sie verarbeitet. Prüfen Sie bei Claude außerdem, ob die Antwort auf dem Kanal des Absenders ankommt und die Sitzung kein session.error zeigt.

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. Führen Sie über die CLI bird webhooks update <webhook_id> --credential name=FILE aus, oder leiten Sie den Wert mit --credential name=- weiter. Über die API senden Sie den geänderten Schlüssel in PATCH /v1/webhooks/{webhook_id} destination.connector.credentials. Die nächste Zustellung verwendet ihn, einschließlich erneuter Versuche.
• Einstellungen ändern. Bearbeiten Sie den Webhook oder führen Sie bird webhooks update <webhook_id> --field name=value aus, um eine Einstellung wie die Agenten-ID, die Vault-ID oder die Webhook-URL einer Grok-Bot-Routine zu ändern. Die nächste Zustellung verwendet den neuen Wert. Um die Plattform zu wechseln, erstellen Sie einen neuen Webhook.
• 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

• MCP Events, für einen MCP-Client, der diese Events selbst abonniert
• Webhooks & Events
• MCP-Server
• Coding-Agent einrichten
• Superagent: Eingehende E-Mail-, SMS- und WhatsApp-Nachrichten bewerten, bevor Ihr Agent sie verarbeitet.