Referenca MCP alata
Konektor izlaže više od 30 alata za sve veze na računu. list_numbers je prvi za WhatsApp, čiji alati primaju connection_id iz tog popisa, a list_social_accounts za ostale kanale, čiji alati primaju account_id. Šest alata blokira se nakon isteka naplate: četiri WhatsApp alata koja djeluju izvan sustava, get_api_credentials, koji vraća pristupni token, i create_connect_link. Ostali ostaju dostupni.
Alati koje konektor izlaže.
Alati koji se blokiraju nakon isteka naplate, uključujući get_api_credentials, koji vraća pristupni token.
OAuth prijava obuhvaća svaki broj na računu.
Što radi svaki alat?
Čitanje: list_numbers vraća povezane brojeve sa statusom, ocjenom kvalitete i razinom razmjene poruka te je početna točka svakog drugog poziva. get_number_health zajedno vraća trenutačnu snimku iz Meta sustava, nedavnu vremensku crtu nadzora, webhook događaje i provjere pollera. get_api_credentials vraća osnovni URL Graph API-ja, WABA id, phone number id i, kada je dostupno, vlastiti pristupni token računa.
Slanje: send_message šalje slobodan tekst unutar 24-satnog prozora, u kojem su odgovori besplatni. send_template šalje odobreni predložak, što je način pokretanja razgovora s osobom koja još nije pisala. list_templates, create_template i get_template_status obuhvaćaju životni ciklus predloška.
Povezivanje: set_webhook_destination usmjerava dolazne poruke i odjeke aplikacije u vaš sustav, a prosljeđivanje vrijednosti null vraća početnu postavku. get_connect_link vraća poveznicu na nadzornu ploču i korake za povezivanje novog broja. get_docs vraća dokumentaciju proizvoda u obliku markdowna.
Partner API, za softver ili agencije čiji vlastiti klijenti povezuju brojeve: get_partner_setup prikazuje naplatu, API ključ, URL za događaje i sljedeći korak. create_api_key izdaje Partner API ključ i prikazuje ga samo jednom, a postojeći ključ ne zamjenjuje bez izričite potvrde. revoke_api_key opoziva ključ, također tek nakon potvrde. set_partner_events_url postavlja kamo idu događaji statusa i jednom vraća tajnu za potpisivanje. create_connect_link stvara hostiranu poveznicu za povezivanje za jednog klijenta, valjanu 1 sat, isto kao POST /api/v1/connect-sessions.
Zašto je connection_id važan?
Zato što povezuje uputu s određenim brojem, a pomoćnik ga ne može pogoditi.
Svaki alat koji djeluje na broj prima connection_id, a list_numbers jedino je mjesto iz kojeg on dolazi. U praksi to znači da će pomoćnik kojemu zatražite slanje poruke najprije pozvati list_numbers, zbog čega je prvi zahtjev u sesiji često sporiji od ostalih.
To također znači da je račun s više brojeva po definiciji nedvosmislen. Ne postoji zadani broj ni prešutni odabir, pa se za uputu koja ne navodi o kojem je broju riječ traži pojašnjenje umjesto nagađanja.
Što se događa kad naplata kasni?
Blokira se šest alata: send_message, send_template, create_template i set_webhook_destination, koji djeluju izvan sustava; get_api_credentials, jer vraća pristupni token računa, kojim bi blokirani račun mogao slati izravno putem Graph API-ja; te create_connect_link, koji povezuje novi broj. Svako drugo čitanje ostaje dostupno, kao i postavljanje Partner API-ja: get_partner_setup, create_api_key, revoke_api_key i set_partner_events_url.
To je namjerna odluka, a ne previd. Račun koji ne može vidjeti zašto je blokiran ili provjeriti jesu li njegovi brojevi zdravi nema drugog puta osim zahtjeva podršci. Isto čitanje potrebno je i za nadzor zdravlja, pa bi njegovo blokiranje isključilo nadzor upravo kad je najpotrebniji.
Praktičan učinak jest da račun nakon isteka naplate i dalje odgovara na pitanja o vlastitom stanju i ostaje pod nadzorom. Zaustavlja se samo ono što dopire do korisnika.
Uobičajene pogreške
- Očekivanje da konektor prima poruke. MCP radi po principu zahtjeva i odgovora, a dolazni promet zahtijeva webhook.
- Tvrdo upisivanje vrijednosti connection_id. Ona dolazi iz alata list_numbers i nije vrijednost koju treba zapisivati.
- Pretpostavka da je račun nakon isteka naplate potpuno izvan mreže. Čitanje i nadzor namjerno se nastavljaju, osim vjerodajnica, koje sadrže token za slanje.
Jedan konektor pokriva svaki broj na računu, uz OAuth autorizaciju i bez lijepljenja ključa. Cijena počinje od US$ 9 po broju mjesečno, pada do US$ 0,75 kako dodajete brojeve, a prva 3 dana su besplatna.
Često postavljana pitanja
Moram li odabrati koji alat pozvati?
Ne. Postavite pitanje običnim jezikom, a pomoćnik odabire alat. Za to su i napisani opisi alata.
Može li čitati moje razgovore?
Ne. Dolazne poruke usmjeravaju se na odredište webhooka koje odredite. Konektor čita stanje računa i brojeva.
Je li get_docs koristan?
Više nego što se čini. Pomoćniku predaje našu dokumentaciju u obliku markdowna, pa odgovori o pravilima Coexistence dolaze iz naše dokumentacije, a ne iz sjećanja.
Pokriva li jedan konektor više klijenata?
Da. Jedan račun može sadržavati onoliko brojeva koliko vam treba, a list_numbers vraća sve njih.
Nastavite čitati
Spremni za početak?
Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.
Započnite besplatno probno razdobljeProvjereno na