Viestit ja puhelut. Kaikki yhdessä paikassa.Tutustu viestintäkeskukseen

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 sovelluksillesi koskien SMS, puheluita, WhatsApp, Telegram ja sähköpostia. Vastaanota Telegram-tapahtumia, kun viesti on jonotettu, lähetetty, epäonnistunut, lopputulos on epävarma tai viesti saapuu yhdistettyyn tiliin, jossa vastaanotto on käytössä. Määritä kaikki visuaalisesti hallintapaneelistasi — ei tarvetta jatkuvalle kyselylle.

Lue API-dokumentaatio

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

SMSPuheluTGSähköposti
allekirjoitettu JSON
SMSMobileAPIWEBHOOK V2Pysyvä tapahtumajono
Elä
HTTPS-posti
CRMTukiAutomaatiotAnalytiikka
Mobiilitapahtuma → pysyvä jono → allekirjoitettu HTTPS-toimitus → työnkulkuusi
20 tapahtumatyyppiä

Kattaa SMS, puhelut, WhatsApp, Telegram ja sähköpostin tarkasti nimetyillä tapahtumilla.

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

SMSMobileAPI

Katso toiminta videolta

Lyhyt video näyttää, miten tämä toimii.

Englanninkielinen video
Katso YouTubessa

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, mobiililaite lähettää tai vastaanottaa SMS-viestin, puhelun tila muuttuu tai tuettu WhatsApp, Telegram ja sähköpostitoiminta 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.

Telegram

5
telegram.submitted

Telegram jonotettu

Telegram-viesti siirtyi lähetysjonoon; tämä ei vahvista toimitusta.

telegram.sent

Telegram lähetetty

Telegram hyväksyi viestin yhdistetystä tilistä; vastaanottajan toimitus- ja lukukuittaukset eivät ole saatavilla.

telegram.failed

Telegram epäonnistui

Telegram-lähetys epäonnistui; mukana on virhekoodi ja lisätiedot.

telegram.unknown

Telegram lopputulos epävarma

Lopputulosta ei voitu vahvistaa; tarkista Telegram ennen uudelleenyritystä.

telegram.received

Telegram vastaanotettu

Uusi yksityisviesti tallennettiin sillä välin kun tilillä oli viestien vastaanotto käytössä.

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 tarkasti, mitkä SMS-, puhelu-, WhatsApp-, Telegram- 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 SMS:ssa, puheluissa, WhatsApp:ssa, Telegram:ssa ja sähköpostissa. Dataobjekti sisältää tapahtumatyypille olennaiset kentät, ja ylätason tunnisteet mahdollistavat jokaisen toimituksen reitityksen ja päällekkäisyyksien poistamisen.

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

Telegram-keskustelut

Lisää juuri vastaanotettu yksityinen Telegram-viesti CRM-järjestelmääsi tai tukisähköpostiin, kun vastaanotto on käytössä.

Vastaamattomien puhelujen palautus

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.

Mobiilitapahtumasta visuaaliseen automaatioon

Et halua rakentaa päätepistettä? Automatisoi samat tapahtumat Workflow Studiossa.

Webhook V2 antaa kehittäjille täydellisen hallinnan allekirjoitettujen HTTPS-toimitusten kautta. Workflow Studio käyttää samoja SMS, puhelu- ja WhatsApp-tapahtumia, jolloin jokainen tiimi voi rakentaa hyödyllisiä automaatioita visuaalisesti hallintapaneelista.

Käytä Webhook V2 omaan koodiisi, Workflow Studiota visuaaliseen automaatioon tai yhdistä molemmat samaan viestintäprosessiin.

01
LaukaisinValitse tarkka mobiilitapahtuma, joka käynnistää työnkulun.
02
AikatauluMääritä päivät, kellonajat, aikavyöhyke tai ajanjakso, jolloin se voi käynnistyä.
03
EhdotSuodata lähettäjän, vastaanottajan, viestin sisällön, avainsanojen tai tapahtumatietojen mukaan.
04
ToimintoLähetä viesti, kutsu päätepistettä, luo ilmoitus tai käynnistä seuraava toimenpide.
Webhook V2 + Workflow Studio

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.

Voinko määrittää useita webhook-osoitteita?+

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.

Milloin Telegram-vastaanotetut webhookit laukeavat?+

Vain uusia yksityisviestejä varten, jotka tallennetaan sillä välin kun Telegram-viestien vastaanotto on käytössä yhteyssivulla. Vastaanotto on oletuksena pois päältä; keskeytettyjä viestejä ei tuoda myöhemmin.

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.

NOPEA DEMO · EI LUOTTOKORTTIA

Kokeile SMSMobileAPIa omalla puhelimellasi.

Yhdistä puhelimesi, lähetä testiviesti ja katso vastaanotetut SMS-viestit vaihe vaiheelta.

Aloita demo