MCP-työkalujen viite
Liitin tarjoaa yksitoista työkalua kaikille tilin numeroille. list_numbers tulee ensin, koska kaikki muut työkalut tarvitsevat siltä saadun connection_id-arvon. Neljä työkalua vaikuttaa ulkoiseen maailmaan, ja niiden käyttö estyy laskutuksen katketessa. Muut seitsemän vain lukevat tietoja ja pysyvät avoimina.
Liittimen tarjoamat työkalut.
Laskutuksen katketessa rajoitetut työkalut. Kaikki lukutoiminnot ovat käytettävissä.
OAuth-kirjautuminen kattaa kaikki tilin numerot.
Mitä kukin työkalu tekee?
Lukeminen: list_numbers palauttaa yhdistetyt numerot, niiden tilan, laatuluokituksen ja viestintätason. Kaikki muut kutsut alkavat tästä. get_number_health palauttaa reaaliaikaisen Metan tilannekuvan sekä viimeisimmän valvonta-aikajanan, webhook-tapahtumat ja kyselytarkistukset yhdessä. get_api_credentials palauttaa Graph API -rajapinnan perus-URL-osoitteen, WABA id:n, phone number id:n ja, jos saatavilla, tilin oman access tokenin.
Lähettäminen: send_message lähettää vapaamuotoisen tekstin 24 tunnin ikkunassa, jossa vastaukset ovat maksuttomia. send_template lähettää hyväksytyn viestipohjan. Näin keskustelu aloitetaan henkilön kanssa, joka ei ole vielä kirjoittanut. list_templates, create_template ja get_template_status kattavat viestipohjan koko elinkaaren.
Kytkennät: set_webhook_destination ohjaa saapuvat viestit ja sovelluksen vastaukset järjestelmääsi. Arvon null välittäminen palauttaa oletusasetuksen. get_connect_link palauttaa hallintapaneelin linkin ja uuden numeron yhdistämisohjeet. get_docs palauttaa tuotteen dokumentaation markdown-muodossa.
Miksi connection_id on tärkeä?
Se yhdistää ohjeen tiettyyn numeroon, eikä avustaja voi päätellä sitä.
Jokainen numeroon vaikuttava työkalu tarvitsee connection_id-arvon, ja list_numbers on ainoa paikka, josta se saadaan. Käytännössä viestin lähettämistä pyytävä avustaja kutsuu ensin list_numbers-työkalua. Siksi istunnon ensimmäinen pyyntö on usein muita hitaampi.
Tämä tekee myös usean numeron tilistä yksiselitteisen. Oletusnumeroa tai implisiittistä valintaa ei ole, joten ohjeessa on kerrottava, mitä numeroa tarkoitetaan. Avustaja kysyy tarvittaessa tarkennusta sen sijaan, että arvaisi.
Mitä tapahtuu, kun laskutus katkeaa?
Neljä ulkoiseen maailmaan vaikuttavaa työkalua rajoitetaan: send_message, send_template, create_template ja set_webhook_destination. Kaikki lukutoiminnot pysyvät käytettävissä.
Tämä on tarkoituksellista. Jos tili ei näe, miksi toiminta on estetty, tai voi tarkistaa numeroidensa kunnon, ainoa reitti takaisin olisi tukipyyntö. Samat lukutoiminnot ovat myös terveyden valvonnan perusta, joten niiden rajoittaminen pysäyttäisi valvonnan juuri silloin, kun sitä eniten tarvitaan.
Käytännössä laskutuksen katkennut tili vastaa edelleen omaa tilaansa koskeviin kysymyksiin ja pysyy valvottuna. Pysähtyy vain kaikki, mikä tavoittaa asiakkaan.
Yleiset virheet
- Odotetaan, että liitin vastaanottaa viestejä. MCP perustuu pyyntöihin ja vastauksiin, joten saapuva liikenne tarvitsee webhookin.
- connection_id-arvo kirjoitetaan kiinteästi koodiin. Se saadaan list_numbers-työkalulta, eikä sitä pidä tallentaa käsin.
- Oletetaan, että laskutuksen katkennut tili on kokonaan poissa käytöstä. Lukutoiminnot ja valvonta jatkuvat tarkoituksella.
Yksi liitin kattaa kaikki tilin numerot, ja OAuth-valtuutus ei vaadi liitettävää avainta. Hinta alkaa 9 US$:sta numeroa kohti kuukaudessa ja laskee volyymissa 2 US$:iin. Ensimmäiset 7 päivää ovat maksuttomia.
Usein kysytyt kysymykset
Valitsenko, mitä työkalua kutsutaan?
Et. Esität pyynnön tavallisella kielellä, ja avustaja valitsee työkalun. Työkalukuvaukset on kirjoitettu juuri tätä varten.
Voiko se lukea keskusteluni?
Ei. Saapuvat viestit ohjataan nimeämääsi webhook-kohteeseen. Liitin lukee tilin ja numeroiden tilatiedot.
Onko get_docs hyödyllinen?
Enemmän kuin nimestä voisi päätellä. Se antaa avustajalle dokumentaatiomme markdown-muodossa, joten Coexistence-sääntöjä koskevat vastaukset perustuvat dokumentaatioomme eivätkä muistiin.
Kattaako yksi liitin useita asiakkaita?
Kyllä. Yhdelle tilille voi lisätä niin monta numeroa kuin tarvitset, ja list_numbers palauttaa ne kaikki.
Lue lisää
Valmis aloittamaan?
Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.
Aloita ilmainen kokeiluVahvistettu