Tekstiviestisi lähetetään omasta puhelimestasi.Katso, miten se toimii
ILMA-AINEISTOAPI-ensimmäinen arkkitehtuuriTurvallisen laitteen paritusToimituksen näkyvyysMonilaiteohjausVersioasiakirjat

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-dokumentaatio

Valitse, mitkä tapahtumat kukin kohde vastaanottaa. Testaa, keskeytä, seuraa ja kierrätä sen allekirjoitussalaisuutta yhdestä työtilasta.

SMSPuheluSähköposti
allekirjoitettu JSON
SMSMobileAPIWebhookV2Pysyvä tapahtumajono
Live
HTTPS POST
AsiakkuudenhallintaTukiAutomaatiotAnalytiikka
Mobiilitapahtuma → pysyvä jono → allekirjoitettu HTTPS-toimitus → työnkulkuusi
15 tapahtumatyyppiä

Kattaa SMS, puhelut, WhatsApp ja sähköpostin tarkoin määritellyillä tapahtumanimillä.

Valikoiva reititys

Lähetä eri tapahtumaryhmät eri HTTPS-kohteisiin.

Allekirjoitettu toimitus

Varmista jokainen pyyntö käyttämällä sen HMAC-SHA256-allekirjoitusta ja aikaleimaa.

Pysyvät uudelleenyritykset

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. 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. 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. 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

5
sms.api.submitted

SMS lähetetty API-kautta

API-pyyntö loi SMS-lähetysjonon. Hyödyllinen vahvistamaan, että pyyntö saapui alustalle.

sms.sent

SMS lähetetty

Liitetty mobiili vahvisti SMS-lähetysoperaation.

sms.failed

SMS epäonnistui

Yhdistetty mobiililaite palautti SMS-lähetysvirheen.

sms.received

SMS vastaanotettu

Yhdistetty mobiililaite synkronoi saapuneen SMS.

sms.mobile.sent

SMS lähetetty mobiililaitteesta

Yhdistetystä mobiililaitteesta lähetettiin manuaalisesti SMS.

Puhelut

3
call.missed

Vastaamaton puhelu

Yhdistetystä mobiililaitteesta synkronoitiin vastaamaton puhelu.

call.incoming

Saapuva puhelu

Yhdistetystä mobiililaitteesta synkronoitiin saapuva puhelu.

call.outgoing

Lähtevä puhelu

Yhdistetystä mobiililaitteesta synkronoitiin lähtevä puhelu.

WhatsApp

5
whatsapp.submitted

WhatsApp lähetetty

Luotiin WhatsApp-lähetystehtävä.

whatsapp.sent

WhatsApp lähetetty

Yhdistetty WhatsApp-ympäristö vahvisti viestin lähetyksen.

whatsapp.failed

WhatsApp epäonnistui

WhatsApp-lähetys epäonnistui.

whatsapp.received

WhatsApp vastaanotettu

Tilin synkronointipyynnön jälkeen haettiin WhatsApp-viesti.

whatsapp.voice.transcribed

Ääniviesti muunnettu tekstiksi.

Kelvollinen haettu WhatsApp-ääniviesti muutettiin käyttökelpoiseksi tekstiksi.

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.

Määritä Webhook V2
Webhook V23 aktiivista
Kohteet3Toimitetut · 24 h1,284Uudelleenyritykset2
CRM-tuotantohttps://crm.example.com/hooks/mobileAktiivinen

sms.receivedcall.missedwhatsapp.received

Toimintahälytyksethttps://ops.example.com/eventsAktiivinen

sms.failedwhatsapp.failed

Esimerkinomaiset Webhook V2-kojelaudan ohjaimet.

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.

01

Kestävä jono

Toimitukseen kelpaavat tapahtumat tallennetaan ennen lähetystä, joten vastaanottimen tilapäinen käyttökatko ei poista tapahtumaa.

02

Toimitus vähintään kerran

Toimitusta voidaan yrittää uudelleen. Tallenna tapahtuman ID ja käsittele se omassa sovelluksessasi vain kerran.

03

Portaitaiset uudelleenyritykset

Tilapäisiä virheitä yritetään uudelleen kasvavilla viiveillä alustan uudelleenyritysrajaan saakka.

04

Virheiden eristäminen

Hidas tai tavoittamaton päätepiste ei estä toimituksia muihin kohteisiin.

05

Automaattinen suojaus

Pitkittyneitä virheitä aiheuttava kohde voidaan keskeyttää suojaamaan jonoa ja infrastruktuuriasi.

06

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ä tapahtumatunniste
  • type— tarkka tapahtumatyyppi
  • occurred_at— milloin toiminta tapahtui
  • data— 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.

Kysely
Onko uusia tapahtumia?Toistuvat pyynnöt · lisäviive
WEBHOOK V2
Tapahtuma
Ilmoita minulle, kun se tapahtuu.Olennaiset tapahtumat · välitön työnkulku

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.