Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

MCP-työkalujen viite

Liitin tarjoaa yli 30 työkalua tilin kaikille yhteyksille. list_numbers tulee ensin WhatsAppille, jonka työkalut tarvitsevat siltä saadun connection_id-arvon, ja list_social_accounts muille kanaville, joiden työkalut tarvitsevat account_id-arvon. Kuuden työkalun käyttö estyy laskutuksen katketessa: neljän ulkoiseen maailmaan vaikuttavan WhatsApp-työkalun, käyttöoikeustunnuksen palauttavan get_api_credentials-työkalun sekä create_connect_link-työkalun. Loput pysyvät avoimina.

30+

Liittimen tarjoamat työkalut.

6

Laskutuksen katketessa rajoitetut työkalut, mukaan lukien käyttöoikeustunnuksen palauttava get_api_credentials.

1

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.

Partner API ohjelmistoille ja toimistoille, joiden omat asiakkaat yhdistävät numeroita: get_partner_setup näyttää laskutuksen, API-avaimen, tapahtumien URL-osoitteen ja seuraavan vaiheen. create_api_key luo Partner API -avaimen ja näyttää sen vain kerran, eikä korvaa olemassa olevaa avainta ilman nimenomaista vahvistusta. revoke_api_key mitätöi avaimen, sekin vasta vahvistuksen jälkeen. set_partner_events_url määrittää, minne tilatapahtumat lähetetään, ja palauttaa allekirjoitussalaisuuden kerran. create_connect_link luo yhdelle asiakkaalle isännöidyn yhdistämislinkin, joka on voimassa 1 tunnin, samoin kuin POST /api/v1/connect-sessions.

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?

Kuusi työkalua rajoitetaan: ulkoiseen maailmaan vaikuttavat send_message, send_template, create_template ja set_webhook_destination; get_api_credentials, koska se palauttaa tilin käyttöoikeustunnuksen, jolla estetty tili voisi lähettää suoraan Graph API:n kautta; sekä uuden numeron yhdistävä create_connect_link. Kaikki muut lukutoiminnot pysyvät käytettävissä, samoin Partner API -asetukset: get_partner_setup, create_api_key, revoke_api_key ja set_partner_events_url.

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, paitsi tunnistetiedot, jotka sisältävät lähettämiseen käytettävän tokenin.
Näin teet tämän EasyCoexistencen avulla

Yksi liitin kattaa kaikki tilin numerot, ja OAuth-valtuutus ei vaadi liitettävää avainta. Hinta alkaa 9 US$:sta numeroa kohti kuukaudessa ja laskee numeroita lisättäessä 1 US$:iin. Ensimmäiset 3 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 kokeilu

Vahvistettu