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 biasa, dan membalas melalui alat apa pun yang Anda berikan, seperti server Bird MCP.

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

1. Di Claude Console, buat agen, environment, dan kunci API.
2. Di Bird, buat webhook, pilih Claude Managed Agents, lalu pilih pesan di bagian Triggers.
3. Di bagian Connect, masukkan agent ID, environment ID, dan kunci API, lalu buat webhook.
4. Pilih Send test.
5. (Opsional) Agar agen dapat membalas melalui Bird, buka agen di Claude Console, pilih + MCP Server, lalu pilih Bird.
6. (Opsional) Buka Managed Agents > Credential vaults, buat vault, pilih + Add credential, atur Type ke MCP OAuth, pilih Bird, lalu pilih Connect.
7. (Opsional) Masukkan vault ID (diawali dengan vlt_) di bagian Connect, atau edit webhook yang sudah ada untuk menambahkannya.

Grok Bot

1. Instal Bird di Grok Bot, lalu hubungkan workspace Bird Anda.
2. Minta Grok Bot membuat rutin dengan webhook trigger. Buka bagian Webhook pada rutin tersebut, lalu salin URL dan sender key-nya.
3. Buat webhook di Bird dengan salah satu cara berikut:
   • Minta Grok Bot membuatnya dengan tujuan Grok Bot untuk event seperti amb.received atau email_mailbox.message_received, menggunakan URL dan sender key dari langkah 2. Untuk email, sebutkan kotak suratnya.
   • Buat di dasbor: pilih Grok Bot, pilih event di bagian Triggers, lalu tempel URL dan sender key di bagian Connect.
4. Pilih Send test, lalu kirim pesan sungguhan ke bisnis atau kotak surat Anda.

Mulai dari template (opsional). Sebelum langkah 2, pilih AMB Booking Desk atau Email Support Desk, lalu berikan bot.md dan shared/message-safety.md template tersebut kepada Grok Bot sebagai instruksi permanen. Isi Your settings dan Knowledge, aktifkan skill kanalnya, dan gunakan Routine prompt-nya untuk langkah 2.

Balasan template secara default berupa draf.

Jika tidak ada run yang dimulai, cocokkan URL Webhook dan sender key rutin tersebut dengan nilai di Bird.

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 di workspace tempat agen Anda berjalan, lalu baca ke dalam lingkungan tanpa menampilkannya, agar tidak pernah muncul di baris perintah atau riwayat shell Anda:

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 menerima destination yang sama di POST /v1/webhooks. 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. 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. Untuk Claude, pastikan balasan sampai di kanal pengirim dan sesi tidak menampilkan session.error.

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} destination.connector.credentials. Pengiriman berikutnya menggunakan kunci tersebut, termasuk percobaan ulang.
• Ubah pengaturannya. Edit webhook untuk mengubah pengaturan seperti agent ID, vault ID, atau webhook URL rutin Grok Bot. Pengiriman berikutnya akan menggunakan pengaturan tersebut. Untuk mengganti platform, buat webhook baru.
• 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

• MCP Events, untuk klien MCP yang berlangganan event ini secara langsung
• Webhook & event
• Server MCP
• Siapkan coding agent Anda
• Superagent: menilai email masuk, pesan SMS dan WhatsApp sebelum agen Anda memprosesnya.