Kattaa SMS, puhelut, WhatsApp ja sähköpostin tarkoin määritellyillä tapahtumanimillä.
WEBHOOK V2 · Kaikki mobiilitapahtumat toimitettuna ohjelmistoosi
Muunna jokainen liitetyn puhelimen tapahtuma välittömäksi toiminnoksi.
SMSMobileAPI Webhook V2 lähettää jäsenneltyjä HTTPS-tapahtumia sovelluksiisi, kun SMS lähetetään, epäonnistuu, toimitetaan tai vastaanotetaan, kun mobiilipuhelu jää vastaamatta, saapuu tai lähtee, sekä kun tuettuja WhatsApp- tai sähköpostitoimintoja kirjataan. Konfiguroi kaikki visuaalisesti kojelaudaltasi — ei tarvetta pollaukselle.
Lue API-dokumentaatioValitse, mitkä tapahtumat kukin kohde vastaanottaa. Testaa, keskeytä, seuraa ja kierrätä sen allekirjoitussalaisuutta yhdestä työtilasta.
Lähetä eri tapahtumaryhmät eri HTTPS-kohteisiin.
Varmista jokainen pyyntö käyttämällä sen HMAC-SHA256-allekirjoitusta ja aikaleimaa.
Väliaikaiset kohdekäsittelyvirheet yritetään uudelleen, eivätkä ne estä muita tilejä.
Miten Webhook V2 toimii
Todellisesta mobiilitapahtumasta sovellukseesi kolmessa selkeässä vaiheessa.
Liitetty mobiilisi ja SMSMobileAPI-palvelut tuottavat operatiivisia tapahtumia. Webhook V2 sijoittaa jokaisen kelvollisen tapahtuman pysyvään toimitusjonoon ja lähettää allekirjoitetun JSON-kuorman valitsemaasi HTTPS URL:lle.
- 1
Tapahtuma tapahtuu
Viesti lähetetään, mobiili lähettää tai vastaanottaa SMS, puhelun tila muuttuu tai tuettuihin WhatsApp- ja sähköpostitoimintoihin liittyvä aktiviteetti kirjataan.
- 2
Webhook V2 reitittää sen
SMSMobileAPI luo yhden pysyvän tapahtuma-ID:n ja jonoittaa toimituksen vain niille kohteille, jotka ovat tilanneet kyseisen tapahtumatyypin.
- 3
Ohjelmistosi reagoi
Julkinen HTTPS-päätepisteesi tarkistaa allekirjoituksen, tallentaa tapahtuma-ID:n ja käynnistää CRM-, tukipalvelu-, hälytys- tai automaatiotyönkulun.
15 tarkkaa tapahtumatyyppiä
Tilaa vain ne mobiilitapahtumat, joita työnkulkusi tarvitsee.
Yksi kohde voi vastaanottaa kaiken, tai voit erotella tuotantojärjestelmät, analytiikan ja operatiiviset hälytykset. Jokaisella tapahtumalla on tarkka nimi, jotta sovelluksesi käsittelee ne ennustettavasti.
SMS
5sms.api.submittedSMS lähetetty API-kautta
API-pyyntö loi SMS-lähetysjonon. Hyödyllinen vahvistamaan, että pyyntö saapui alustalle.
sms.sentSMS lähetetty
Liitetty mobiili vahvisti SMS-lähetysoperaation.
sms.failedSMS epäonnistui
Yhdistetty mobiililaite palautti SMS-lähetysvirheen.
sms.receivedSMS vastaanotettu
Yhdistetty mobiililaite synkronoi saapuneen SMS.
sms.mobile.sentSMS lähetetty mobiililaitteesta
Yhdistetystä mobiililaitteesta lähetettiin manuaalisesti SMS.
Puhelut
3call.missedVastaamaton puhelu
Yhdistetystä mobiililaitteesta synkronoitiin vastaamaton puhelu.
call.incomingSaapuva puhelu
Yhdistetystä mobiililaitteesta synkronoitiin saapuva puhelu.
call.outgoingLähtevä puhelu
Yhdistetystä mobiililaitteesta synkronoitiin lähtevä puhelu.
whatsapp.submittedWhatsApp lähetetty
Luotiin WhatsApp-lähetystehtävä.
whatsapp.sentWhatsApp lähetetty
Yhdistetty WhatsApp-ympäristö vahvisti viestin lähetyksen.
whatsapp.failedWhatsApp epäonnistui
WhatsApp-lähetys epäonnistui.
whatsapp.receivedWhatsApp vastaanotettu
Tilin synkronointipyynnön jälkeen haettiin WhatsApp-viesti.
whatsapp.voice.transcribedÄäniviesti muunnettu tekstiksi.
Kelvollinen haettu WhatsApp-ääniviesti muutettiin käyttökelpoiseksi tekstiksi.
Sähköposti
2email.sentSähköposti lähetetty
SMSMobileAPI loi sähköpostin lähetyspyynnön.
email.receivedSähköposti vastaanotettu
Yhdistetty postilaatikko vastaanotti sähköpostin.
Määritä kaikki visuaalisesti
Ammattilaismainen webhook-hallinta ilman konfiguraatiotiedostojen muokkaamista.
Avaa Webhook V2 SMSMobileAPI-hallintapaneelissa, lisää kohteen nimi ja julkinen HTTPS URL, valitse tapahtumat ja tallenna. Hallintapaneeli tarjoaa tarvitut ohjaimet päivittäiseen käyttöön ja vianetsintään.
Useita kohteita
Luo erilliset kohteet CRM:ääsi, monitorointia, analytiikkaa tai asiakassovelluksia varten.
Tapahtumasuodattimet
Valitse tarkkaan, mitkä SMS-, puhelu-, WhatsApp- ja sähköpostitapahtumat kukin URL vastaanottaa.
Toimituksen testaus
Lähetä hallittu testitapahtuma ennen kuin luotat kohteeseen tuotannossa.
Keskeytä ja aktivoi uudelleen
Pysäytä yksittäinen kohde välittömästi ilman, että poistat sen konfiguraation.
Salaisuuden kierto
Luo uusi allekirjoitussalaisuus, kun turvallisuusprosessisi sitä vaatii.
Toimitustoiminta
Tarkastele jonossa olevia, toimitettuja, uudelleenyrityksessä olevia ja epäonnistuneita toimituksia yritys- ja HTTP-tilatiedoilla.
https://crm.example.com/hooks/mobileAktiivinensms.receivedcall.missedwhatsapp.received
https://ops.example.com/eventsAktiivinensms.failedwhatsapp.failed
Luotettavuutta alusta alkaen
Suunniteltu luotettavaan, itsenäiseen toimitukseen.
Webhook-toimitus on asynkroninen. Mobiilityönkulku ei odota kolmannen osapuolen URL:n vastausta, eikä yhden epäonnistuvan kohteen ongelma estä toista asiakasta tai kohdetta.
Kestävä jono
Toimitukseen kelpaavat tapahtumat tallennetaan ennen lähetystä, joten vastaanottimen tilapäinen käyttökatko ei poista tapahtumaa.
Toimitus vähintään kerran
Toimitusta voidaan yrittää uudelleen. Tallenna tapahtuman ID ja käsittele se omassa sovelluksessasi vain kerran.
Portaitaiset uudelleenyritykset
Tilapäisiä virheitä yritetään uudelleen kasvavilla viiveillä alustan uudelleenyritysrajaan saakka.
Virheiden eristäminen
Hidas tai tavoittamaton päätepiste ei estä toimituksia muihin kohteisiin.
Automaattinen suojaus
Pitkittyneitä virheitä aiheuttava kohde voidaan keskeyttää suojaamaan jonoa ja infrastruktuuriasi.
Operatiivinen näkyvyys
Kojelauta ja ylläpidon valvonta näyttävät jonon kunnon, tulokset ja viimeaikaiset toimitusvirheet.
Allekirjoitettu ja todennettavissa
Varmista pyyntö ennen kuin luotat tapahtumaan.
Jokainen toimitus sisältää aikaleiman, toimitustunnisteen, tapahtumatyypin, pysyvän idempotenssiavaimen ja HMAC-SHA256-allekirjoituksen. Säilytä allekirjoitussalaisuus palvelimellasi, laske allekirjoitus raakatietopyynnön rungosta ja hylkää virheelliset tai vanhentuneet pyynnöt.
X-SMSMobileAPI-EventTapahtumatyyppi, kuten sms.received.X-SMSMobileAPI-DeliveryTämän kohteen yksilöllinen toimitustunniste.X-SMSMobileAPI-TimestampUnix-aikaleima, jota käytetään allekirjoituksen tarkistuksessa.X-SMSMobileAPI-SignatureHMAC-SHA256-allekirjoitus turvallista vertailua varten.Idempotency-KeyPysyvä tapahtuma-UUID, jota käytetään kaksinkertaisen käsittelyn estämiseen.Yhtenäinen tapahtumakuori
Yksi yhtenäinen JSON-kuori kaikille kanaville.
Kuori pysyy ennustettavana kanavasta riippumatta: SMS, puhelut, WhatsApp ja sähköposti. Data-objekti sisältää tapahtumatyyppiin liittyvät kentät, ja ylätason tunnisteet mahdollistavat jokaisen toimituksen reitityksen ja duplikaattien eston.
id— pysyvä tapahtumatunnistetype— tarkka tapahtumatyyppioccurred_at— milloin toiminta tapahtuidata— kanavakohtaiset tiedot
{
"id": "whv2_01J...",
"type": "sms.received",
"api_version": "2026-09-22",
"created_at": "2026-09-22T12:00:00Z",
"occurred_at": "2026-09-22T11:59:58Z",
"data": {
"guid": "...",
"from": "+32...",
"message": "Can you call me back?"
}
}Tapahtumasta liiketoimintatulokseen
Käytä mobiiliviestintää seuraavan liiketoimintatoimenpiteen käynnistämiseen.
CRM-keskustelut
Lisää vastaanotettu SMS- tai WhatsApp-viesti oikealle kontaktille ja hälytä vastuuhenkilö.
Vastaamattoman puhelun jälkihoito
Luo takaisinsoittotehtävä, lähetä seurantaviestinä SMS tai ilmoita päivystävälle tiimille vastaamattoman puhelun jälkeen.
Asiakastuki
Avaa tai päivitä tukipyyntö, kun asiakas vastaa mobiililaitteellaan.
Verkkokaupan toiminnot
Päivitä tilausviestinnän työnkulut sen jälkeen, kun mobiiliviesti on lähetetty, vahvistettu tai epäonnistunut.
Valvonta ja hälytykset
Lähetä toimitusvirheet tai poikkeava puhelutoiminta valvonta- ja häiriöhallintatyökaluihisi.
Tekoäly- ja datatyönkulut
Syötä valtuutetut tapahtumat luokittelu-, raportointi- tai avustustyönkulkuihin ilman jatkuvaa kyselyä palveluun API.
Lopeta muutosten jatkuva kysely
Kyselyt toistuvat jatkuvasti. Webhookit ilmoittavat ohjelmistollesi, kun jotain muuttuu.
Kyselyt kuluttavat pyyntöjä myös silloin, kun mitään ei ole tapahtunut, ja lisäävät viiveitä tarkistusten väliin. Webhook V2 työntää olennaisen tapahtuman päätepisteeseesi, mikä tekee automaatiosta nopeampaa, yksinkertaisempaa ja helpommin skaalautuvaa.
Webhook V2 — UKK
Kysymyksiä ennen päätepisteen yhdistämistä.
Täytyykö minun rakentaa kyselysilmukka?+
Ei. Webhook V2 lähettää tilatut tapahtumat julkiselle HTTPS-päätepisteellesi. Voit silti käyttää API-rajapintoja, kun sinun tarvitsee hakea historiaa tai yksityiskohtia.
Can I configure several webhook URLs?+
Kyllä. Voit luoda useita kohteita ja valita eri tapahtumasarjan jokaiselle, tilin rajoissa, jotka näkyvät hallintapaneelissa.
Mistä tiedän, että SMS todella lähetettiin?+
Käytä sms.api.submitted-tapahtumaa tietääksesi, että työ luotiin, ja sms.sent-tapahtumaa liitetyn mobiilin raportoimaan vahvistukseen. Käsittele niitä kahdessa eri toimintavaiheessa.
Voidaanko webhook-toimitus tehdä useammin kuin kerran?+
Kyllä. Webhook V2 käyttää vähintään kerran -toimitusperiaatetta. Tallenna tapahtuman pysyvä tunniste tai Idempotency-Key ja ohita toimitus, jonka olet jo käsitellyt.
Mitä päätepisteeni pitää palauttaa?+
Palauta HTTP 2xx -vastaus sen jälkeen, kun olet turvallisesti hyväksynyt tapahtuman. Käsittely voi jatkua asynkronisesti sovelluksessasi.
Kerätäänkö vastaanotetut WhatsApp -tapahtumat jatkuvasti?+
Ei. WhatsApp:n vastaanotettujen viestien haku noudattaa omaa suostumukseen perustuvaa synkronointiprosessiaan. whatsapp.received -tapahtuma on saatavilla sen jälkeen, kun kelvollinen viesti on haettu.
Mobiilitapahtumasi. Ohjelmistosi. Toimesi.
Yhdistä ohjelmistosi todellisen mobiililaitteesi toimintaan nyt.
Luo tilisi tai kirjaudu sisään, avaa Webhook V2, lisää julkinen HTTPS-kohde ja valitse ne tapahtumat, jotka ovat tärkeitä työnkulullesi. Lähetä testitapahtuma, tarkista sen allekirjoitus ja ota integraatio käyttöön.
