Referensi alat MCP
Konektor membuka lebih dari 30 alat untuk setiap koneksi dalam akun. list_numbers digunakan lebih dulu untuk WhatsApp, yang alatnya memerlukan connection_id darinya, dan list_social_accounts untuk kanal lainnya, yang alatnya memerlukan account_id. Enam alat dibatasi saat tagihan terlewat: empat alat WhatsApp yang berinteraksi dengan dunia luar, get_api_credentials yang mengembalikan token akses, dan create_connect_link. Sisanya tetap tersedia.
Alat yang dibuka konektor.
Alat yang dibatasi saat tagihan terlewat, termasuk get_api_credentials yang mengembalikan token akses.
Masuk melalui OAuth, mencakup setiap nomor dalam akun.
Apa yang dilakukan setiap alat?
Pembacaan: list_numbers mengembalikan nomor yang terhubung beserta status, peringkat kualitas, dan tingkat pengiriman pesan, serta menjadi awal setiap panggilan lainnya. get_number_health mengembalikan snapshot Meta langsung bersama linimasa pemantauan terbaru, event webhook, dan pemeriksaan poller. get_api_credentials mengembalikan URL dasar Graph API, WABA id, phone number id, serta token akses milik akun jika tersedia.
Pengiriman: send_message mengirim teks bebas dalam jendela 24 jam, sehingga balasan tidak dikenai biaya. send_template mengirim template yang disetujui, yaitu cara memulai percakapan dengan seseorang yang belum menulis. list_templates, create_template, dan get_template_status mencakup seluruh siklus template.
Pengaturan: set_webhook_destination mengarahkan pesan masuk dan gema aplikasi ke sistem Anda, sedangkan null akan mengatur ulang tujuan tersebut. get_connect_link mengembalikan tautan dashboard dan langkah untuk menghubungkan nomor baru. get_docs mengembalikan dokumentasi produk dalam format markdown.
Partner API, untuk perangkat lunak atau agensi yang pelanggannya sendiri menghubungkan nomor: get_partner_setup menampilkan status tagihan, kunci API, URL event, dan langkah berikutnya. create_api_key menerbitkan kunci Partner API dan menampilkannya sekali saja, serta tidak mengganti kunci yang ada tanpa konfirmasi eksplisit. revoke_api_key mencabut kunci itu, juga setelah konfirmasi. set_partner_events_url mengatur ke mana event status dikirim dan mengembalikan rahasia penandatanganan sekali saja. create_connect_link membuat tautan koneksi yang di-hosting untuk satu pelanggan, berlaku 1 jam, sama seperti POST /api/v1/connect-sessions.
Mengapa connection_id penting?
Karena nilai ini mengaitkan instruksi dengan nomor tertentu, dan asisten tidak dapat menebaknya.
Setiap alat yang bekerja pada nomor memerlukan connection_id, dan list_numbers adalah satu-satunya sumbernya. Dalam praktiknya, asisten yang diminta mengirim pesan akan memanggil list_numbers terlebih dahulu. Itulah sebabnya permintaan pertama dalam sebuah sesi sering kali lebih lambat daripada permintaan berikutnya.
Hal ini juga membuat akun dengan beberapa nomor tetap jelas. Tidak ada nomor bawaan dan tidak ada pemilihan implisit, sehingga instruksi yang tidak menyebutkan nomor akan ditanyakan, bukan ditebak.
Apa yang terjadi saat tagihan terlewat?
Enam alat dibatasi: send_message, send_template, create_template, dan set_webhook_destination, yang berinteraksi dengan dunia luar; get_api_credentials, karena mengembalikan token akses akun yang memungkinkan akun yang diblokir mengirim langsung melalui Graph API; dan create_connect_link, yang menghubungkan nomor baru. Semua pembacaan lain tetap tersedia, begitu pula penyiapan Partner API: get_partner_setup, create_api_key, revoke_api_key, dan set_partner_events_url.
Hal ini memang disengaja, bukan kelalaian. Akun yang tidak dapat melihat alasan pemblokiran atau memeriksa kesehatan nomornya tidak memiliki jalan kembali selain tiket dukungan. Pembacaan yang sama juga diperlukan pemantauan kesehatan, sehingga membatasinya akan mematikan pemantauan tepat saat paling dibutuhkan.
Dampak praktisnya, akun dengan tagihan terlewat tetap dapat menjawab pertanyaan tentang kondisinya sendiri dan tetap dipantau. Yang berhenti adalah segala hal yang menjangkau pelanggan.
Kesalahan umum
- Mengira konektor menerima pesan. MCP menggunakan permintaan dan respons; lalu lintas masuk memerlukan webhook.
- Menetapkan connection_id secara manual. Nilai ini berasal dari list_numbers dan bukan sesuatu yang perlu dicatat.
- Menganggap akun dengan tagihan terlewat sepenuhnya offline. Pembacaan dan pemantauan tetap berjalan dengan sengaja, kecuali kredensial, yang memuat token untuk mengirim.
Satu konektor mencakup setiap nomor dalam akun, diotorisasi melalui OAuth tanpa kunci yang perlu ditempel. Mulai dari US$ 9 per nomor terhubung per bulan, turun hingga US$ 0,75 seiring bertambahnya nomor, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah saya memilih alat yang akan dipanggil?
Tidak. Anda bertanya dengan bahasa biasa dan asisten memilihnya. Itulah tujuan penulisan deskripsi alat tersebut.
Bisakah alat ini membaca percakapan saya?
Tidak. Pesan masuk diarahkan ke tujuan webhook yang Anda tentukan. Konektor membaca kondisi akun dan nomor.
Apakah get_docs berguna?
Lebih berguna daripada kedengarannya. Alat ini memberikan dokumentasi kami kepada asisten dalam format markdown, sehingga jawaban tentang aturan Coexistence berasal dari dokumentasi kami, bukan dari ingatan.
Apakah satu konektor dapat mencakup beberapa klien?
Ya. Satu akun dapat menampung sebanyak mungkin nomor yang Anda perlukan, dan list_numbers mengembalikan semuanya.
Lanjut membaca
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai uji coba gratisDiverifikasi pada