Referință pentru instrumentele MCP
Conectorul expune unsprezece instrumente pentru fiecare număr dintr-un cont. `list_numbers` este primul, deoarece toate celelalte instrumente folosesc un `connection_id` preluat de acolo. Patru acționează în lumea externă și se blochează la neplată; celelalte șapte doar citesc și rămân disponibile.
Instrumentele expuse de conector.
Instrumentele blocate la neplată. Toate citirile rămân disponibile.
Autentificare OAuth pentru fiecare număr din cont.
Ce face fiecare instrument?
Citire: `list_numbers` returnează numerele conectate, cu statusul, evaluarea calității și nivelul de mesagerie, fiind punctul de pornire pentru orice alt apel. `get_number_health` returnează împreună o imagine actualizată din Meta, istoricul recent al monitorizării, evenimentele webhook și verificările pollerului. `get_api_credentials` returnează URL-ul de bază al Graph API, WABA id, phone number id și, dacă este disponibil, propriul token de acces al contului.
Trimitere: `send_message` trimite text liber în intervalul de 24 de ore, când răspunsurile sunt gratuite. `send_template` trimite un șablon aprobat, acesta fiind modul de a începe o conversație cu cineva care nu a scris. `list_templates`, `create_template` și `get_template_status` acoperă ciclul de viață al șablonului.
Configurare: `set_webhook_destination` direcționează mesajele primite și ecourile aplicației către sistemul dumneavoastră, iar transmiterea valorii null îl resetează. `get_connect_link` returnează linkul către panoul de control și pașii pentru conectarea unui număr nou. `get_docs` returnează documentația produsului în format markdown.
De ce contează `connection_id`?
Pentru că leagă o instrucțiune de un anumit număr, iar un asistent nu îl poate ghici.
Orice instrument care acționează asupra unui număr primește un `connection_id`, iar `list_numbers` este singurul loc de unde acesta provine. În practică, un asistent căruia i se cere să trimită un mesaj va apela mai întâi `list_numbers`, motiv pentru care prima cerere dintr-o sesiune este adesea mai lentă decât următoarele.
Astfel, un cont cu mai multe numere rămâne lipsit de ambiguități. Nu există un număr implicit și nici o selecție automată, așa că o instrucțiune care nu precizează numărul vizat este cerută pentru clarificare, nu ghicită.
Ce se întâmplă când plata abonamentului întârzie?
Cele patru instrumente care acționează în lumea externă sunt blocate: `send_message`, `send_template`, `create_template` și `set_webhook_destination`. Tot ce ține de citire rămâne disponibil.
Acest lucru este intenționat, nu o omisiune. Un cont care nu poate vedea de ce este blocat sau verifica dacă numerele sale sunt sănătoase nu mai are altă cale de revenire în afară de o solicitare către suport. Aceleași citiri sunt necesare și pentru monitorizarea stării, astfel încât blocarea lor ar opri monitorizarea exact când este cel mai necesară.
În practică, un cont cu plata întârziată continuă să răspundă la întrebări despre propria stare și rămâne monitorizat. Se oprește doar orice acțiune care ajunge la un client.
Greșeli frecvente
- Așteptarea ca acest conector să primească mesaje. MCP funcționează prin cereri și răspunsuri; traficul primit are nevoie de un webhook.
- Codificarea manuală a unui `connection_id`. Acesta provine din `list_numbers` și nu este o valoare de notat.
- Presupunerea că un cont cu plata întârziată este complet offline. Citirile și monitorizarea continuă intenționat.
Un singur conector acoperă toate numerele unui cont, autorizat prin OAuth, fără nicio cheie de copiat. De la US$ 9 per număr pe lună, până la US$ 2 la volum, cu primele 7 zile gratuite.
Întrebări frecvente
Aleg eu ce instrument să apelez?
Nu. Formulați cererea în limbaj obișnuit, iar asistentul alege instrumentul potrivit, exact pentru acest scop fiind scrise descrierile lor.
Îmi poate citi conversațiile?
Nu. Mesajele primite sunt direcționate către destinația webhook aleasă de dumneavoastră. Conectorul citește starea contului și a numerelor.
Este util `get_docs`?
Mai mult decât pare. Oferă asistentului documentația noastră în format markdown, astfel încât răspunsurile despre regulile Coexistence să provină din documentația noastră, nu din memorie.
Un singur conector acoperă mai mulți clienți?
Da. Un cont poate conține oricâte numere aveți nevoie, iar `list_numbers` le returnează pe toate.
Continuați să citiți
Gata să începeți?
Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.
Începeți perioada de probă gratuităVerificat la