# Rutekan pesan ke agen AI Anda

Bird mengirim setiap pesan yang Anda terima di WhatsApp, SMS, Apple Messages, atau kotak surat agen ke agen AI Anda. Hubungkan agen sekali dengan detail dan kredensialnya, dan setiap pesan baru akan sampai ke agen tersebut.

Dua agen didukung:

- **Claude Managed Agents**: setiap pesan memulai sesi dari agen yang Anda buat di Claude Console.
- **Grok Bot**: setiap pesan mengaktifkan salah satu rutin Grok Bot Anda.

Bird mengirim setiap pesan yang cocok ke agen Anda dan mencoba ulang pengiriman yang gagal, sehingga pesan yang dicoba ulang dapat memulai eksekusi baru. Agen menerima JSON event dari pesan tersebut, payload yang sama yang diterima oleh [endpoint webhook](/docs/guides/webhooks) biasa, dan membalas melalui alat apa pun yang Anda berikan, seperti [server Bird MCP](/docs/ai/mcp-server).

## Pilih pesan yang dijawab agen Anda

Agen Anda hanya dapat menjawab pesan masuk: `whatsapp.received`, `sms.received`, `amb.received` (Apple Messages), dan `email_mailbox.message_received`. Pilih pesan yang harus ditangani agen. Tanda terima pengiriman, perubahan status, dan event lainnya tidak dikirim ke agen.

## Claude Managed Agents

Pertama, siapkan agen Anda di [Claude Console](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session): buat agen beserta environment-nya, dan buat [kunci API](https://platform.claude.com/settings/keys) di workspace yang sama. Catat agent ID dan environment ID. Sesi baru menggunakan versi terbaru agen.

Kemudian hubungkan di Bird:

1. [Buat webhook](https://bird.com/dashboard/w/webhooks/new) dan pilih **Claude Managed Agents**.
2. Di bagian **Triggers**, pilih pesan yang harus dijawab Claude.
3. Di bagian **Connect**, beri nama webhook lalu masukkan agent ID, environment ID, dan kunci API.
4. Tinjau webhook dan buat.

Setiap pesan memulai sesi yang pesan pengguna pertamanya adalah `New Bird event:` diikuti oleh event JSON.

## Grok Bot

Pertama, minta Grok Bot membuat routine dengan webhook trigger. Grok Bot akan memberikan webhook URL dan sender key routine tersebut. Untuk mengatur trigger secara manual, lihat [webhook trigger Cursor](https://cursor.com/docs/cloud-agent/automations#webhook-triggers).

Kemudian hubungkan di Bird:

1. [Buat webhook](https://bird.com/dashboard/w/webhooks/new) dan pilih **Grok Bot**.
2. Di bagian **Triggers**, pilih pesan yang harus dijawab Grok Bot.
3. Di bagian **Connect**, beri nama webhook lalu tempel webhook URL dan sender key.
4. Tinjau webhook dan buat.

Setiap pesan mengirimkan event JSON ke webhook URL rutin tersebut, dengan sender key sebagai Bearer token, dan rutin menjalankan prompt yang tersimpan.

## Buat dari CLI atau API

`bird webhooks create --help` mencantumkan setiap konektor beserta field-nya, mana yang bersifat rahasia, event yang diterima, dan persiapan yang perlu dilakukan terlebih dahulu. Kirim field non-rahasia dengan `--field name=value` dan setiap rahasia dari variabel lingkungan dengan `--secret-env name=ENV_VAR`, atau pipe dengan `--secret-stdin name`, agar tidak masuk ke riwayat shell Anda. `--events` secara default mencakup semua event pesan yang diterima konektor.

Untuk Claude, buat [kunci API](https://platform.claude.com/settings/keys) di workspace tempat agen Anda berjalan, lalu baca ke dalam lingkungan tanpa menampilkannya, agar tidak pernah muncul di baris perintah atau riwayat shell Anda:

```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
```

API menerima `destination` yang sama di [`POST /v1/webhooks`](/docs/api/reference/create-webhook). Jangan sertakan `url`: Bird membuatnya dari konektor. Tidak ada respons yang menyertakan kredensial.

## Uji koneksi

Segera setelah membuat webhook, pilih **Send test**. Selanjutnya, gunakan **Send test event** di halaman webhook atau di aksi barisnya, atau panggil [`POST /v1/webhooks/{webhook_id}/test`](/docs/api/reference/test-webhook). Periksa di Claude atau Cursor apakah sesi atau run telah dimulai. Kemudian kirim pesan sungguhan ke salah satu nomor atau kanal Anda dan pastikan agen menanganinya.

## Operasikan

- **Rotasi kredensial.** Edit webhook dan masukkan hanya nilai baru; field yang Anda kosongkan tetap menyimpan nilai sebelumnya. Melalui API, kirim kunci yang diubah di [`PATCH /v1/webhooks/{webhook_id}`](/docs/api/reference/update-webhook) `credentials`. Pengiriman berikutnya menggunakannya, termasuk percobaan ulang.
- **Arahkan ke agen lain.** Buat webhook baru. Pengeditan tidak dapat mengganti platform atau mengubah pengaturan seperti agent ID atau webhook URL.
- **Jeda atau hapus.** Menjeda webhook menghentikan pengirimannya. Menghapusnya akan menghapus kredensialnya.
- **Lihat kegagalan.** Daftar percobaan webhook menampilkan setiap pengiriman beserta status respons dan isi dari platform, atau kosong jika platform tidak dapat dijangkau. Percobaan yang gagal sebelum Bird mengirim apa pun, misalnya koneksi berubah setelah event, membawa `failure_reason` sebagai gantinya.

## Langkah berikutnya

- [Webhook & event](/docs/guides/webhooks)
- [Server MCP](/docs/ai/mcp-server)
- [Siapkan coding agent Anda](/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)