---
title: "Kieruj wiadomości do swojego agenta AI"
description: "Wysyłaj każdą wiadomość WhatsApp, SMS, Apple Messages lub e-mail do Claude lub Grok Bot. Skonfiguruj to z poziomu dashboardu, CLI lub API."
canonical: "https://bird.com/pl-pl/dokumentacja/ai/route-messages-to-an-agent"
---

# Kieruj wiadomości do swojego agenta AI

Bird wysyła każdą wiadomość otrzymaną przez WhatsApp, SMS, Apple Messages lub skrzynkę agenta do Twojego agenta AI. Podłącz agenta raz, podając jego dane i poświadczenia, a każda nowa wiadomość do niego trafi.

Obsługiwani są dwaj agenci:

- **Claude Managed Agents**: każda wiadomość rozpoczyna sesję agenta utworzonego w Claude Console.
- **Grok Bot**: każda wiadomość uruchamia jedną z Twoich procedur Grok Bot.

Bird wysyła każdą pasującą wiadomość do Twojego agenta i ponawia dostarczenie, które się nie powiodło, więc ponowiona wiadomość może rozpocząć kolejne uruchomienie. Agent otrzymuje zdarzenie JSON wiadomości, ten sam payload, który otrzymuje zwykły [endpoint webhooka](/docs/guides/webhooks), i odpowiada za pomocą narzędzi, które mu udostępnisz, np. [serwera Bird MCP](/docs/ai/mcp-server).

## Wybierz wiadomości, na które odpowiada Twój agent

Twój agent może odpowiadać tylko na wiadomości przychodzące: `whatsapp.received`, `sms.received`, `amb.received` (Apple Messages) i `email_mailbox.message_received`. Wybierz te, które agent ma obsługiwać. Potwierdzenia dostarczenia, zmiany statusu i inne zdarzenia nie są wysyłane do agenta.

## Claude Managed Agents

1. W Claude Console utwórz [agenta](https://platform.claude.com/workspaces/default/agents/new), [środowisko](https://platform.claude.com/workspaces/default/environments/new) i [klucz API](https://platform.claude.com/settings/keys).
2. W Bird [utwórz webhook](https://bird.com/dashboard/w/webhooks/new), wybierz **Claude Managed Agents** i zaznacz wiadomości w sekcji **Triggers**.
3. W sekcji **Connect** wprowadź identyfikator agenta, identyfikator środowiska i klucz API, a następnie utwórz webhook.
4. Wybierz **Send test**.
5. (Opcjonalnie) Aby agent mógł odpowiadać przez Bird, otwórz agenta w Claude Console, wybierz **+ MCP Server** i wskaż **Bird**.
6. (Opcjonalnie) Otwórz **Managed Agents** > **Credential vaults**, utwórz sejf, wybierz **+ Add credential**, ustaw **Type** na **MCP OAuth**, wskaż **Bird** i wybierz **Connect**.
7. (Opcjonalnie) Wprowadź identyfikator sejfu (zaczyna się od `vlt_`) w sekcji **Connect** albo edytuj istniejący webhook, aby go dodać.

## Grok Bot

Najpierw poproś Grok Bota o utworzenie rutyny z wyzwalaczem webhook. Otrzymasz URL webhooka rutyny i klucz nadawcy. Aby skonfigurować wyzwalacz ręcznie, zobacz [wyzwalacze webhook w Cursorze](https://cursor.com/docs/cloud-agent/automations#webhook-triggers).

Następnie połącz go w Bird:

1. [Utwórz webhook](https://bird.com/dashboard/w/webhooks/new) i wybierz **Grok Bot**.
2. W sekcji **Triggers** wybierz wiadomości, na które Grok Bot ma odpowiadać.
3. W sekcji **Connect** nadaj webhookowi nazwę i wklej URL webhooka oraz klucz nadawcy.
4. Sprawdź webhook i utwórz go.

Każda wiadomość wysyła zdarzenie JSON na adres URL webhooka rutyny z kluczem nadawcy jako tokenem Bearer, a rutyna uruchamia swój zapisany prompt.

## Utwórz z poziomu CLI lub API

`bird webhooks create --help` wyświetla każdy konektor z jego polami, informacją które z nich są tajne, akceptowanymi zdarzeniami i wymaganą wstępną konfiguracją. Przekaż jawne pola za pomocą `--field name=value`, a każdy sekret ze zmiennej środowiskowej za pomocą `--secret-env name=ENV_VAR` lub przekieruj go przez `--secret-stdin name`, żeby nie trafił do historii powłoki. `--events` domyślnie obejmuje każde zdarzenie wiadomości akceptowane przez konektor.

W przypadku Claude utwórz [klucz API](https://platform.claude.com/settings/keys) w obszarze roboczym, w którym działa Twój agent, a następnie wczytaj go do zmiennej środowiskowej bez wyświetlania, żeby nigdy nie pojawił się w wierszu poleceń ani w historii powłoki:

```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 \
  --field vault_id=vlt_123 --secret-env api_key=ANTHROPIC_API_KEY
```

API przyjmuje te same `destination` w [`POST /v1/webhooks`](/docs/api/reference/create-webhook). Pomiń `url`: Bird buduje go na podstawie konektora. Żadna odpowiedź nie zawiera danych uwierzytelniających.

## Przetestuj połączenie

Zaraz po utworzeniu webhooka wybierz **Send test**. Później użyj **Send test event** na stronie webhooka lub w akcjach wiersza albo wywołaj [`POST /v1/webhooks/{webhook_id}/test`](/docs/api/reference/test-webhook). Sprawdź w Claude lub Cursorze, czy rozpoczęła się sesja lub uruchomienie. Następnie wyślij prawdziwą wiadomość na jeden ze swoich numerów lub kanałów i potwierdź, że agent ją obsługuje; w przypadku Claude potwierdź, że odpowiedź dociera na kanał nadawcy, a sesja nie pokazuje `session.error`.

## Zarządzaj webhookiem

- **Wymień dane uwierzytelniające.** Edytuj webhook i wprowadź tylko nową wartość; pole pozostawione puste zachowuje zapisaną wartość. Przez API wyślij zmieniony klucz w [`PATCH /v1/webhooks/{webhook_id}`](/docs/api/reference/update-webhook) `destination.connector.credentials`. Następne dostarczenie użyje go, łącznie z ponownymi próbami.
- **Zmień ustawienia.** Edytuj webhook, aby zmienić ustawienie takie jak identyfikator agenta, identyfikator sejfu czy URL webhooka rutyny Grok Bot; następne dostarczenie użyje nowej wartości. Aby zmienić platformę, utwórz nowy webhook.
- **Wstrzymaj lub usuń.** Wstrzymanie webhooka zatrzymuje jego dostarczenia. Usunięcie kasuje jego dane uwierzytelniające.
- **Odczytuj błędy.** Lista prób webhooka pokazuje każde dostarczenie ze statusem odpowiedzi i treścią zwróconą przez platformę albo brak danych, gdy platforma była nieosiągalna. Próba, która nie powiodła się, zanim Bird cokolwiek wysłał, na przykład z powodu zmiany połączenia po zdarzeniu, zawiera zamiast tego `failure_reason`.

## Następne kroki

- [MCP Events](/docs/ai/mcp-events), dla klienta MCP, który samodzielnie subskrybuje te zdarzenia
- [Webhooki i zdarzenia](/docs/guides/webhooks)
- [Serwer MCP](/docs/ai/mcp-server)
- [Skonfiguruj swojego agenta programistycznego](/docs/ai/set-up-your-agent)
- [Superagent](/ai/superagent): oceń przychodzące wiadomości e-mail, SMS i WhatsApp, zanim Twój agent podejmie działanie.

## 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)