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. Untuk menekan penggunaan token agen, aktifkan hanya alat Bird yang digunakannya, seperti yang dijelaskan di Claude Managed Agents.
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

Konektor webhook mencantumkan field setiap konektor, field mana yang bersifat rahasia, event yang diterimanya, dan persiapan yang perlu dilakukan terlebih dahulu. bird webhooks create --connector <id> --request-schema menampilkan field yang sama sebagai JSON Schema. Kirim field non-rahasia dengan --field name=value dan setiap rahasia dengan --credential name=FILE dari file, atau dengan --credential name=- yang disalurkan melalui stdin, agar rahasia tidak masuk ke riwayat shell Anda. Secara default, --events mencakup semua event pesan yang diterima konektor.

Untuk Claude, buat kunci API di workspace tempat agen Anda berjalan, lalu baca kunci tersebut ke variabel shell tanpa menampilkannya dan salurkan melalui pipe, agar tidak pernah muncul di baris perintah atau riwayat shell Anda:

read -rs 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 --credential api_key=- <<< "$ANTHROPIC_API_KEY"

bird webhooks connect <connector> melakukan semua ini dalam satu langkah. Perintah ini menyebutkan field yang masih dibutuhkan konektor, membuat webhook, lalu menampilkan ID webhook, event, dan filter kotak surat tanpa rahasia apa pun. Di bawah next, perintah ini menyebutkan bird webhooks test untuk webhook tersebut, yang memeriksa field-nya dengan platform. Melalui MCP, webhooks_create dengan connector_id melakukan hal yang sama dalam satu panggilan, dan next-nya menyebutkan panggilan webhooks_test.

Untuk mengirim email dari satu kotak surat ke agen, tambahkan --mailbox dengan ID atau alamat kotak surat tersebut. Alamat akan dicari terlebih dahulu, sehingga memerlukan scope mailbox:read. Opsi ini mengatur filter.mailbox_id, lalu --events secara default mencakup event kotak surat yang tercantum pada aksi konektor, atau email_mailbox.message_received untuk aksi yang menerima semua event. Untuk Grok Bot, ganti YOUR_MAILBOX_ADDRESS dan YOUR_ROUTINE_WEBHOOK_URL dengan kotak surat Anda dan URL webhook rutin, lalu tempel sender key rutin saat read memintanya:

read -rs GROK_SENDER_KEY  # paste the sender key, then press Enter
bird webhooks connect grok_bot --mailbox YOUR_MAILBOX_ADDRESS \
  --field webhook_url=YOUR_ROUTINE_WEBHOOK_URL \
  --credential sender_key=- <<< "$GROK_SENDER_KEY"

Setiap pengiriman email_mailbox.message_received memuat pesan di bawah data: data.message_id, data.mailbox_id, dan data.thread_id, pengirim di data.from, penerima di data.to, serta data.subject, yang bernilai null jika pesan tidak memilikinya. data.extracted_text adalah isi pesan tanpa riwayat kutipan, bernilai null jika tidak ada teks, dan dibatasi hingga 64 KB. data.truncated_text bernilai true jika isi tersebut terpotong. Referensi event mencantumkan setiap field.

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, jalankan bird webhooks test <webhook_id>, atau panggil POST /v1/webhooks/{webhook_id}/test. Pembuatan atau pembaruan dari CLI atau API menyebutkan langkah ini di next. Menyimpan webhook tidak menghubungi platform, sehingga uji inilah yang memeriksa field-nya. Untuk Claude Managed Agents, uji ini membaca agen alih-alih memulai sesi, sehingga membuktikan kunci API dan agent ID, lalu melaporkan kind: probe. Jika jawaban platform mengidentifikasi nilai yang salah, field menyebutkannya. Probe tidak mengirim event, sehingga pesan sungguhan pertama menjadi pemeriksaan menyeluruh. Untuk Grok Bot, uji ini memulai run rutin dengan event yang ditandai "test": true, jadi periksa di Cursor apakah 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. Dari CLI, jalankan bird webhooks update <webhook_id> --credential name=FILE, atau salurkan nilainya melalui pipe dengan --credential name=-. 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, atau jalankan bird webhooks update <webhook_id> --field name=value, untuk mengubah pengaturan seperti agent ID, vault ID, atau URL webhook 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.