Rujukan alat MCP
Penyambung menyediakan sebelas alat untuk setiap nombor dalam akaun. list_numbers didahulukan kerana semua alat lain memerlukan connection_id daripadanya. Empat alat berinteraksi dengan dunia luar dan disekat apabila bayaran tertunggak; tujuh lagi hanya membaca dan kekal terbuka.
Alat yang disediakan oleh penyambung.
Alat yang disekat apabila bayaran tertunggak. Semua bacaan kekal tersedia.
Log masuk OAuth, meliputi setiap nombor dalam akaun.
Apakah fungsi setiap alat?
Bacaan: list_numbers mengembalikan nombor yang disambungkan bersama status, penarafan kualiti dan peringkat pemesejan, dan menjadi permulaan setiap panggilan lain. get_number_health mengembalikan gambaran langsung Meta bersama garis masa pemantauan terkini, peristiwa webhook dan semakan poller. get_api_credentials mengembalikan URL asas Graph API, WABA id, phone number id dan, jika tersedia, access token akaun itu sendiri.
Penghantaran: send_message menghantar teks bebas dalam tetingkap 24 jam, dan balasan adalah percuma. send_template menghantar template yang diluluskan, iaitu cara memulakan perbualan dengan seseorang yang belum menulis. list_templates, create_template dan get_template_status meliputi kitar hayat template.
Pendawaian: set_webhook_destination menghalakan mesej masuk dan gema aplikasi ke sistem anda, manakala penghantaran null menetapkan semula destinasi itu. get_connect_link mengembalikan pautan dashboard dan langkah untuk menyambungkan nombor baharu. get_docs mengembalikan dokumentasi produk dalam format markdown.
Mengapa connection_id penting?
Kerana connection_id mengikat arahan kepada nombor tertentu, dan pembantu tidak boleh meneka nilainya.
Setiap alat yang bertindak pada nombor memerlukan connection_id, dan list_numbers ialah satu-satunya tempat untuk mendapatkannya. Dalam amalan, pembantu yang diminta menghantar mesej akan memanggil list_numbers dahulu. Sebab itu permintaan pertama dalam sesi sering lebih perlahan daripada permintaan seterusnya.
Ini juga bermakna akaun yang mempunyai beberapa nombor kekal tidak mengelirukan. Tiada nombor lalai dan tiada pemilihan tersirat, jadi arahan yang tidak menyatakan nombor yang dimaksudkan akan ditanya semula, bukan diteka.
Apakah berlaku apabila bayaran tertunggak?
Empat alat yang berinteraksi dengan dunia luar disekat: send_message, send_template, create_template dan set_webhook_destination. Semua alat yang hanya membaca kekal tersedia.
Ini disengajakan, bukan terlepas pandang. Akaun yang tidak dapat melihat sebab ia disekat atau menyemak kesihatan nombornya tiada jalan kembali selain tiket sokongan. Bacaan yang sama juga diperlukan untuk pemantauan kesihatan, jadi menyekatnya akan mematikan pemantauan ketika seseorang paling memerlukannya.
Kesan praktikalnya, akaun yang bayaran tertunggak masih menjawab soalan tentang keadaannya dan masih dipantau. Yang terhenti ialah apa-apa tindakan yang mencapai pelanggan.
Kesilapan biasa
- Menjangkakan penyambung menerima mesej. MCP menggunakan permintaan dan respons; trafik masuk memerlukan webhook.
- Menetapkan connection_id secara keras. Nilainya datang daripada list_numbers dan bukan nilai untuk dicatat.
- Menganggap akaun yang bayaran tertunggak terputus sepenuhnya. Bacaan dan pemantauan terus berjalan dengan sengaja.
Satu penyambung meliputi setiap nombor dalam akaun, diberi kuasa melalui OAuth tanpa kunci untuk ditampal. Daripada US$ 9 sebulan bagi setiap nombor, turun kepada US$ 2 mengikut jumlah, dengan 7 hari pertama percuma.
Soalan lazim
Adakah saya memilih alat yang hendak dipanggil?
Tidak. Anda bertanya dalam bahasa biasa dan pembantu memilihnya. Itulah tujuan penerangan alat tersebut.
Bolehkah ia membaca perbualan saya?
Tidak. Mesej masuk dihalakan ke destinasi webhook yang anda tetapkan. Penyambung membaca keadaan akaun dan nombor.
Adakah get_docs berguna?
Lebih berguna daripada yang disangka. Ia menyerahkan dokumentasi kami kepada pembantu dalam format markdown, jadi jawapan tentang peraturan Coexistence datang daripada dokumentasi kami, bukan ingatan.
Adakah satu penyambung meliputi beberapa pelanggan?
Ya. Satu akaun boleh menyimpan seberapa banyak nombor yang anda perlukan dan list_numbers mengembalikan semuanya.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaDisahkan pada