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, i odpowiada za pomocą narzędzi, które mu udostępnisz, np. serwera Bird MCP.

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, środowisko i klucz API.
2. W Bird utwórz webhook, 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.

Następnie połącz go w Bird:

1. Utwórz webhook 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 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:

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. 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. 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} 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, dla klienta MCP, który samodzielnie subskrybuje te zdarzenia
• Webhooki i zdarzenia
• Serwer MCP
• Skonfiguruj swojego agenta programistycznego
• Superagent: oceń przychodzące wiadomości e-mail, SMS i WhatsApp, zanim Twój agent podejmie działanie.