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

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-Schlüssel 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:

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 \
  --field vault_id=vlt_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 Sitzung oder ein Run 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. Ü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, 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.