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

Pertama, siapkan agen Anda di Claude Console: buat agen beserta environment-nya, dan buat kunci API di workspace yang sama. Catat agent ID dan environment ID. Sesi baru menggunakan versi terbaru agen.

Kemudian hubungkan di Bird:

Buat webhook dan pilih Claude Managed Agents.
Di bagian Triggers, pilih pesan yang harus dijawab Claude.
Di bagian Connect, beri nama webhook lalu masukkan agent ID, environment ID, dan kunci API.
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.

Kemudian hubungkan di Bird:

Buat webhook dan pilih Grok Bot.
Di bagian Triggers, pilih pesan yang harus dijawab Grok Bot.
Di bagian Connect, beri nama webhook lalu tempel webhook URL dan sender key.
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 di workspace tempat agen Anda berjalan, lalu baca ke dalam lingkungan tanpa menampilkannya, agar tidak pernah muncul di baris perintah atau riwayat shell Anda:

Contoh kode

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

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

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.

Dapatkan ringkasan implementasi

Sumber daya terkait