Reference ng MCP tools
Naglalantad ang connector ng mahigit 30 tool para sa bawat koneksyon sa isang account. Nauuna ang list_numbers para sa WhatsApp, na ang mga tool ay kumukuha ng connection_id nito, at ang list_social_accounts para sa iba pang channel, na ang mga tool ay kumukuha ng account_id. Anim ang naka-gate kapag nag-lapse ang billing: ang apat na tool ng WhatsApp na kumikilos sa labas ng system, ang get_api_credentials na nagbabalik ng access token, at ang create_connect_link. Ang iba pa ay nananatiling bukas.
Mga tool na inilalantad ng connector.
Mga tool na naka-gate kapag nag-lapse ang billing, kasama ang get_api_credentials na nagbabalik ng access token.
OAuth sign in para sa bawat numero sa account.
Ano ang ginagawa ng bawat tool?
Pagbabasa: Ibinabalik ng list_numbers ang mga naka-connect na numero kasama ang status, quality rating at messaging tier. Dito nagsisimula ang bawat ibang call. Ibinabalik ng get_number_health ang live na snapshot mula sa Meta, pati ang kamakailang monitoring timeline, webhook events at poller checks. Ibinabalik ng get_api_credentials ang Graph API base URL, WABA id, phone number id at, kung available, ang sariling access token ng account.
Pagpapadala: Nagpapadala ang send_message ng free text sa loob ng 24-hour window, kung saan libre ang mga sagot. Nagpapadala ang send_template ng aprubadong template, na ginagamit para simulan ang pag-uusap sa taong hindi pa nagme-message. Sinasaklaw ng list_templates, create_template at get_template_status ang buong template lifecycle.
Pagkonekta: Niruruta ng set_webhook_destination ang mga papasok na mensahe at app echo sa inyong system; kapag null ang ipinasa, nire-reset ito. Ibinabalik ng get_connect_link ang dashboard link at mga hakbang para mag-connect ng bagong numero. Ibinabalik ng get_docs ang product documentation bilang markdown.
Partner API, para sa software o agency na ang sariling mga customer ang nagkokonekta ng numero: ipinapakita ng get_partner_setup ang billing, API key, events URL at ang susunod na hakbang. Gumagawa ang create_api_key ng Partner API key at ipinapakita ito nang isang beses, at hindi nito pinapalitan ang kasalukuyang key nang walang malinaw na kumpirmasyon. Binabawi ito ng revoke_api_key, pagkatapos din ng kumpirmasyon. Itinatakda ng set_partner_events_url kung saan pupunta ang mga status event at ibinabalik ang signing secret nang isang beses. Gumagawa ang create_connect_link ng hosted connect link para sa isang customer, valid nang 1 oras, katulad ng POST /api/v1/connect-sessions.
Bakit mahalaga ang connection_id?
Ito ang nag-uugnay sa isang instruction sa partikular na numero, at hindi ito maaaring hulaan ng assistant.
Lahat ng tool na kumikilos sa isang numero ay tumatanggap ng connection_id, at ang list_numbers lamang ang pinanggagalingan nito. Sa aktuwal na paggamit, kapag inatasang magpadala ng mensahe ang assistant, tatawag muna ito sa list_numbers. Kaya kadalasang mas mabagal ang unang request sa isang session kaysa sa mga kasunod.
Ibig sabihin din nito, malinaw ang paggamit sa account na may maraming numero. Walang default na numero at walang implicit selection, kaya kapag hindi tinukoy ng instruction kung aling numero ang tinutukoy, magtatanong ang assistant sa halip na manghula.
Ano ang nangyayari kapag nag-lapse ang billing?
Anim ang naka-gate na tool: send_message, send_template, create_template at set_webhook_destination, na kumikilos sa labas ng system; get_api_credentials, dahil ibinabalik nito ang access token ng account, na magpapahintulot sa isang naka-block na account na magpadala nang direkta sa Graph API; at create_connect_link, na nagkokonekta ng bagong numero. Available pa rin ang lahat ng iba pang read, pati ang setup ng Partner API: get_partner_setup, create_api_key, revoke_api_key at set_partner_events_url.
Sinasadya ito at hindi ito oversight. Kung hindi makita ng account kung bakit ito na-block, o hindi masuri kung healthy ang mga numero nito, wala itong malinaw na daan pabalik maliban sa support ticket. Ang mga read na ito rin ang ginagamit ng health monitoring, kaya kapag ni-gate ang mga ito, mamamatay ang monitoring sa oras na pinakakailangan ito.
Ang praktikal na epekto: nakasasagot pa rin ang nag-lapse na account sa mga tanong tungkol sa sarili nitong state at patuloy pa rin itong namo-monitor. Ang tumitigil ay anumang umaabot sa customer.
Mga karaniwang pagkakamali
- Inaasahang makatatanggap ng mga mensahe ang connector. Request at response ang MCP; kailangan ng webhook para sa papasok na traffic.
- Manu-manong nagse-set ng connection_id. Galing ito sa list_numbers at hindi ito value na dapat isulat o i-hardcode.
- Inaakalang ganap na offline ang nag-lapse na account. Patuloy ang reads at monitoring dahil sinadya ito, maliban sa credentials, na may dalang access token na ginagamit sa pagpapadala.
Isang connector para sa lahat ng numero sa account, na ina-authorize sa OAuth at walang key na kailangang i-paste. Mula US$ 9 kada numero kada buwan, bumababa hanggang US$ 0.75 habang nadaragdagan ang mga numero, at libre ang unang 3 araw.
Mga madalas itanong
Kayo ba ang pipili kung aling tool ang tatawagin?
Hindi. Magtanong po kayo sa plain language at pipili ang assistant, dahil para rito isinulat ang mga tool description.
Mababasa ba nito ang mga conversation ko?
Hindi. Niruruta ang mga papasok na mensahe sa webhook destination na itatalaga ninyo. Binabasa ng connector ang state ng account at numero.
Kapaki-pakinabang ba ang get_docs?
Higit pa sa inaakala. Ibinibigay nito sa assistant ang aming documentation bilang markdown, kaya mula sa aming docs ang mga sagot tungkol sa Coexistence rules, hindi sa memorya.
Sinasaklaw ba ng isang connector ang ilang client?
Oo. Maaaring maglaman ang isang account ng maraming numerong kailangan ninyo, at ibinabalik ng list_numbers ang lahat ng ito.
Magpatuloy sa pagbabasa
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng TrialNa-verify noong