Miten lisäät WhatsAppin SaaS-tuotteeseesi Embedded Signupin ja Coexistencen avulla
SaaS-tuote lisää WhatsAppin yhdistämällä jokaisen asiakkaan olemassa olevan numeron Metan Embedded Signupin ja Coexistencen kautta, jolloin numero toimii edelleen WhatsApp Business -sovelluksessa. easyCoexistencen Partner API:n avulla yksi yhdistämisistunto asiakasta kohden ajaa tämän prosessin hostatulla sivulla, Meta toimittaa numeron viestit webhook_url-osoitteeseesi ja taustajärjestelmäsi vastaa Cloud API:n kautta asiakkaan oman tokenin avulla.
Kiinteä läpimenonopeus numerolle, jota käytetään sekä WhatsApp Business -sovelluksen että Cloud API:n kanssa.
Vanhin WhatsApp Business -sovellusversio, jolla asiakkaan numero voi yhdistyä Coexistencen kautta.
Kuinka pitkälle taaksepäin Metan jaettavissa oleva chat-historia ulottuu käyttöönotossa; se on synkronoitava 24 tunnin sisällä.
WhatsAppin asiakaspalveluikkuna käyttäjän viestin tai puhelun jälkeen; jokainen uusi viesti nollaa sen.
Päivämäärä, jolloin Meta poisti käytöstä Embedded Signup v2:n ja v3:n, ja integraatiot on siirretty v4:ään.
Mistä WhatsApp-integraatio koostuu?
Viisi, ja easyCoexistence ottaa haltuunsa ensimmäisen ja viimeisen. Tuotteesi hoitaa keskustelulogiikan, saapuneet viestit ja sen, mitä mallisi tai asiakkaidesi henkilöstö kirjoittavat, kun Meta kuljettaa viestit numeron ja palvelimesi välillä:
Mitä Coexistence muuttaa asiakkaillesi?
He säilyttävät numeronsa ja puhelimensa. WhatsApp Business -sovellus toimii edelleen Cloud API:n rinnalla, joten henkilöstö vastaa puhelimella ja tuotteesi vastaa rajapinnan kautta. Sovelluksesta lähetetyt viestit saapuvat webhookiisi smb_message_echoes-kenttänä. Tähän kuuluu kolme rajoitusta: numero lähettää kiinteällä 20 viestillä sekunnissa, vain API voi lähettää viestipohjia ja Meta irrottaa numeron, jos puhelin pysyy käyttämättömänä noin 14 päivää.
Miltä yhdistämisvaihe näyttää tuotteessasi?
Yhdistä WhatsApp -painike kutsuu taustajärjestelmästäsi POST /connect-sessions -rajapintaa, jossa on redirect_url, asiakkaasi id external_ref-kenttänä sekä webhook_url ja webhook_verify_token, jolloin Meta ohjaa numeron sinulle heti alusta alkaen. Asiakas vahvistaa lyhyen tarkistuslistan hostatulla sivulla, käynnistää Metan ponnahdusikkunan, skannaa QR-koodin WhatsApp Business -sovelluksella ja palaa sinulle connection_id:n kanssa. Sitä, käytetäänkö Embedded Signupia omasta Tech Provider -sovelluksestasi, harkitaan Embedded Signup -oppaassa.
Miten viestit kulkevat taustajärjestelmääsi?
Metalta suoraan webhook_url-osoitteeseesi, ilman pysähdystä easyCoexistencessä eikä kopiota tallennettuna. messages-kenttä kuljettaa asiakkaiden lähettämät viestit ja lähettämiesi viestien tilan, ja smb_message_echoes kuljettaa henkilöstön sovelluksesta lähettämät viestit. Meta allekirjoittaa jokaisen toimituksen easyCoexistencen sovelluksen salaisuudella, jota ei koskaan jaeta, joten URL-polun pitkä satunnainen salaisuus todentaa toimituksen. Kaksi numeroa samassa WhatsApp Business -tilissä jakavat kohteen: reititä value.metadata.phone_number_id-kentän perusteella.
Miten taustajärjestelmäsi vastaa ja lähettää viestipohjia?
Metan Graph API:lla ja asiakkaan tokenilla, joka saadaan kutsulla GET /connections/{id}?credentials=1; sama vastaus palauttaa myös send_endpoint-osoitteen. Vapaamuotoinen viesti lähtee 24 tunnin sisällä henkilön viimeisimmästä viestistä, sen jälkeen vain Metan hyväksymä viestipohja:
- Vastaus: POST /<
PHONE_NUMBER_ID>/messages tyypillä text ikkunan sisällä. - Viestipohja: sama kutsu tyypillä template, viestipohjan nimi ja sen kielikoodi.
- Viestipohjan luonti: POST /<
WABA_ID>/message_templates, sitten kysele sen tilaa, koska tarkastustulokset eivät saavuwebhook_url-osoitteeseesi. - Media: POST /<
PHONE_NUMBER_ID>/media lataamiseen; saapuva media tulee tunnisteena, joka haetaan samalla tokenilla.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $CUSTOMER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "text",
"text": { "body": "Your table for 4 is booked for 8 pm." }
}'Voiko tuotteesi tuoda asiakkaan nykyiset chatit?
Kerran, yhdistämisen yhteydessä. Kun istunnolle on asetettu webhook_url, easyCoexistence pyytää Metaa lähettämään numeron kontaktit ja, jos asiakas hyväksyy sen sovelluksessa, jopa 180 päivän chatit. Ne saapuvat smb_app_state_sync- ja history-webhookeina. Meta sallii tuonnin vain 24 tunnin sisällä yhdistämisestä, joten päätepisteen on vastattava ennen kuin linkki lähtee. Chat-historian opas kuvaa sisällöt.
Kuka maksaa Metalle viesteistä?
Asiakkaasi. Meta laskuttaa taustajärjestelmäsi API:n kautta lähettämät viestit asiakkaan omalle WhatsApp Business -tilille, maksutavalla, jonka asiakas lisää sinne, eikä yritys ilman maksutapaa voi lähettää markkinointiviestipohjia. easyCoexistence veloittaa tiliäsi yhdistettyä numeroa kohden eikä koskaan veloita viesteistä eikä korota Metan hintoja.
Mitä tapahtuu, kun numero putoaa?
Tapahtumien URL-osoitteesi vastaanottaa connection.disconnected-tapahtuman Metan syyn kanssa, kun se tiedetään. PRIMARY_INACTIVITY tarkoittaa 14 päivän sääntöä, ja uusi yhdistämisistunto kyseiselle asiakkaalle palauttaa saman numeron. connection.token_missing tarkoittaa, että numero yhdistettiin ilman asiakkaan tokenia: se vastaanottaa viestejä, mutta ei voi lähettää ennen kuin uusi istunto yhdistää sen.
Yleiset virheet
- Yhdistämislinkin lähettäminen ennen kuin webhook-päätepisteesi vastaa. Historian tuonti tapahtuu kerran, 24 tunnin sisällä yhdistämisestä, ja sisältö, joka lähetetään ennen kuin URL-osoitteesi toimii, menetetään.
- Vapaamuotoisen viestin lähettäminen ikkunan sulkeuduttua. Kun henkilön viimeisimmästä viestistä on kulunut 24 tuntia, vain hyväksytty viestipohja menee läpi.
- Kampanjan ajaminen yhdestä numerosta täydellä nopeudella. Coexistence-numero lähettää 20 viestiä sekunnissa, joten jonota jokaisen numeron lähetykset tuolla nopeudella.
- Olettaa, että henkilöstö lähettää viestipohjia puhelimesta. Coexistencessä vain API voi lähettää ne, joten lisää viestipohjien lähetykset tuotteeseesi.
easyCoexistence lisää WhatsAppin SaaS-tuotteeseesi Metan Embedded Signupin ja Coexistencen avulla hostatulla sivulla, jossa näkyy oma nimesi. Asiakkaasi säilyttävät numeronsa ja WhatsApp Business -sovelluksen, Meta toimittaa viestit palvelimellesi ja tapahtumat saapuvat allekirjoitettuina. Sama rajapinta yhdistää Instagramin, Facebookin, TikTokin, YouTuben, LinkedInin ja muita kanavia. US$ 9–US$ 0,75 per yhteys kuukaudessa, ja hinta laskee, kun lisäät yhteyksiä. Ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Voiko asiakas yhdistää numeron, joka on toisen WhatsApp API -palveluntarjoajan käytössä?
Ei, niin kauan kuin numero on siellä. Hostattu tarkistuslista vaatii numeron, jolla ei ole muuta API-palveluntarjoajaa eikä automaatiotyökalua, joten asiakkaan täytyy irrottaa numero siitä palveluntarjoajasta ensin.
Voiko tuotteeni lähettää WhatsApp-viestipohjia asiakkailleen?
Kyllä, Cloud API:n kautta kunkin asiakkaan tokenilla: luo viestipohja asiakkaan WhatsApp Business -tilille, odota Metan tarkastusta ja lähetä se sitten.
Lukeeko easyCoexistence asiakkaideni WhatsApp-viestejä?
Ei. Meta toimittaa numeron viestit suoraan asettamaasi webhook_url-osoitteeseen. Numero ilman webhook_url-osoitetta siirtyy easyCoexistencen takaisinkutsuun, jossa viestit hylätään tallentamatta niitä.
Paljonko easyCoexistence maksaa WhatsApp-numeroa kohden?
US$ 9–US$ 0,75 numeroa kohden kuukaudessa kokonaisyhteyksien määrän mukaan, ensimmäiset 3 päivää ilmaiseksi. Metan viestimaksut menevät kunkin asiakkaan omalle WhatsApp Business -tilille.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu