# 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](/docs/guides/webhooks) erhält – und antwortet über die Tools, die Sie ihm bereitgestellt haben, etwa den [Bird-MCP-Server](/docs/ai/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](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session) ein: Erstellen Sie den Agenten und seine Umgebung sowie einen [API-Schlüssel](https://platform.claude.com/settings/keys) 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:

1. [Erstellen Sie einen Webhook](https://bird.com/dashboard/w/webhooks/new) und wählen Sie **Claude Managed Agents**.
2. Wählen Sie unter **Triggers** die Nachrichten aus, die Claude beantworten soll.
3. Geben Sie unter **Connect** dem Webhook einen Namen und tragen Sie die Agent-ID, die Environment-ID und den API-Key ein.
4. 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](https://cursor.com/docs/cloud-agent/automations#webhook-triggers).

Verbinden Sie ihn dann in Bird:

1. [Erstellen Sie einen Webhook](https://bird.com/dashboard/w/webhooks/new) und wählen Sie **Grok Bot**.
2. Wählen Sie unter **Triggers** die Nachrichten aus, die Grok Bot beantworten soll.
3. Geben Sie unter **Connect** dem Webhook einen Namen und fügen Sie die Webhook-URL und den Sender-Key ein.
4. Ü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](https://platform.claude.com/settings/keys) 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:

```bash
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`](/docs/api/reference/create-webhook). 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`](/docs/api/reference/test-webhook) 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}`](/docs/api/reference/update-webhook) `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

- [Webhooks & Events](/docs/guides/webhooks)
- [MCP-Server](/docs/ai/mcp-server)
- [Coding-Agent einrichten](/docs/ai/set-up-your-agent)

## Related resources

- [Setting up your coding agent](/learn/basics/setting-up-your-coding-agent) (video)
- [What is an MCP server, and how does an agent use one to send messages?](/explained/platform/what-is-an-mcp-server-and-how-does-an-agent-send-messages) (answer)
- [Coding agents](/ai) (product)
- [Build with AI agents](/learn/paths/agents) (course)

[Get an implementation brief](/learn/workspace?topic=agents)