Je SMS worden vanaf je eigen mobiel verstuurd.Ontdek hoe het werkt
PLATFORMAPI-eerste architectuurBeveiligde apparaat koppelingZichtbaarheid van de leveringMulti-apparaatbesturingVersiede documentatie

WEBHOOK V2 · Elk mobiel event, direct afgeleverd in uw software

Zet elk event van uw gekoppelde mobiel om in een onmiddellijke actie.

SMSMobileAPI Webhook V2 stuurt gestructureerde HTTPS-evenementen naar uw applicaties wanneer een SMS wordt ingediend, verzonden, mislukt of ontvangen, wanneer een mobiel gesprek gemist, inkomend of uitgaand is, en wanneer ondersteunde WhatsApp- of e-mailactiviteit plaatsvindt. Stel alles visueel in via uw dashboard—geen polling-loop nodig.

Lees de API-documentatie

Kies welke events elke bestemming ontvangt. Test, pauzeer, bewaak en roteer de ondertekeningssleutel vanuit één workspace.

SMSOproepE-mail
ondertekende JSON
SMSMobileAPIWebhookV2Duurzame gebeurteniswachtrij
Live
HTTPS POST
CRMSupportAutomatiseringAnalytics
Mobiele gebeurtenis → duurzame wachtrij → levering van ondertekende HTTPS → uw workflow
15 gebeurtenistypen

Omvat SMS, oproepen, WhatsApp en e-mail met nauwkeurige gebeurtenisnamen.

Selectieve routering

Stuur verschillende eventgroepen naar verschillende HTTPS-bestemmingen.

Ondertekende levering

Verifieer elk verzoek met de HMAC-SHA256-handtekening en tijdstempel.

Robuuste herhaalpogingen

Tijdelijke fouten bij bestemmingen worden opnieuw geprobeerd zonder andere accounts te blokkeren.

Hoe Webhook V2 werkt

Van een echte mobiele gebeurtenis naar uw applicatie in drie heldere stappen.

Uw gekoppelde mobiel en SMSMobileAPI-services genereren operationele gebeurtenissen. Webhook V2 plaatst elk in aanmerking komend event in een duurzame leveringswachtrij en stuurt een ondertekende JSON payload naar de door u geselecteerde HTTPS URL.

  1. 1

    Een gebeurtenis treedt op

    Een bericht wordt ingediend, een mobiel verzendt of ontvangt een SMS, een gesprek verandert van status, of ondersteunde WhatsApp- en e-mailactiviteit wordt vastgelegd.

  2. 2

    Webhook V2 routeert het

    SMSMobileAPI maakt één stabiel event-ID aan en plaatst een levering alleen in de wachtrij voor bestemmingen die op dat eventtype zijn geabonneerd.

  3. 3

    Uw software reageert

    Uw publieke HTTPS-endpoint verifieert de handtekening, slaat het event-ID op en start uw CRM-, support-, alert- of automatiseringsworkflow.

15 precieze gebeurtenistypen

Abonneer u alleen op de mobiele events die uw workflow nodig heeft.

Een bestemming kan alles ontvangen, of u kunt productieomgevingen, analytics en operationele waarschuwingen scheiden. Elk event heeft een precieze naam, zodat uw applicatie het voorspelbaar kan afhandelen.

SMS

5
sms.api.submitted

SMS ingediend via API

Een API-verzoek heeft een SMS verzendtaak aangemaakt. Handig om te bevestigen dat het verzoek in het platform is aangekomen.

sms.sent

SMS verzonden

Het gekoppelde mobiele apparaat heeft de SMS-verzending bevestigd.

sms.failed

SMS mislukt

De gekoppelde mobiele telefoon gaf een verzendfout: SMS.

sms.received

SMS ontvangen

Een gekoppelde mobiele telefoon synchroniseerde een binnenkomende SMS.

sms.mobile.sent

SMS verzonden vanaf mobiel

Een SMS werd handmatig vanaf de gekoppelde mobiele telefoon verzonden.

Oproepen

3
call.missed

Gemiste oproep

Een gemiste oproep werd vanuit een gekoppelde mobiele telefoon gesynchroniseerd.

call.incoming

Binnenkomende oproep

Een binnenkomende oproep werd vanuit een gekoppelde mobiele telefoon gesynchroniseerd.

call.outgoing

Uitgaande oproep

Een uitgaande oproep werd vanuit een gekoppelde mobiele telefoon gesynchroniseerd.

WhatsApp

5
whatsapp.submitted

WhatsApp ingediend

Er is een verzendtaak voor WhatsApp aangemaakt.

whatsapp.sent

WhatsApp verzonden

De gekoppelde WhatsApp-omgeving heeft bevestigd dat het bericht is verzonden.

whatsapp.failed

WhatsApp mislukt

De verzendactie voor WhatsApp is mislukt.

whatsapp.received

WhatsApp ontvangen

Een WhatsApp-bericht werd opgehaald nadat het account synchronisatie had aangevraagd.

whatsapp.voice.transcribed

Spraakbericht getranscribeerd

Een opgehaald WhatsApp-spraakbericht dat in aanmerking kwam, werd omgezet in bruikbare tekst.

Configureer alles visueel

Professioneel beheer van webhooks zonder configuratiebestanden te bewerken.

Open Webhook V2 in het SMSMobileAPI-dashboard, voeg een bestemmingsnaam en openbare HTTPS URL toe, selecteer de gebeurtenissen en sla op. Het dashboard biedt de bedieningselementen die nodig zijn voor dagelijkse werking en probleemoplossing.

Meerdere bestemmingen

Maak specifieke bestemmingen voor uw CRM, monitoring, analytics of klantapplicaties.

Evenementfilters

Selecteer precies welke SMS-, oproep-, WhatsApp- en e-mailgebeurtenissen elke URL ontvangt.

Bezorging testen

Stuur een gecontroleerde testgebeurtenis voordat u de bestemming in productie gebruikt.

Pauzeren en opnieuw activeren

Stop een bestemming direct zonder de configuratie te verwijderen.

Rotatie van geheime sleutels

Genereer een nieuwe ondertekeningssleutel wanneer uw beveiligingsproces dit vereist.

Bezorgingsactiviteit

Bekijk wachtrij-, bezorgde-, opnieuw probeerde- en mislukte leveringen met informatie over pogingen en HTTP-status.

Configureer Webhook V2
Webhook V23 actief
Bestemmingen3Bezorgd · 24u1,284Opnieuw proberen2
CRM-productiehttps://crm.example.com/hooks/mobileActief

sms.receivedcall.missedwhatsapp.received

Operationele meldingenhttps://ops.example.com/eventsActief

sms.failedwhatsapp.failed

Voorbeeld van Webhook V2 dashboardbediening.

Betrouwbaarheid door ontwerp

Ontworpen voor betrouwbare, onafhankelijke levering.

Webhook-aflevering is asynchroon. Uw mobiele workflow wacht niet op een derde partij URL om te reageren, en één falende bestemming blokkeert geen andere klant of bestemming.

01

Persistente wachtrij

In aanmerking komende gebeurtenissen worden opgeslagen vóór levering, zodat tijdelijke uitval van de ontvanger het evenement niet verwijdert.

02

Aflevering minstens eenmaal

Een aflevering kan worden herhaald. Sla de event-ID op en verwerk deze slechts één keer in uw eigen applicatie.

03

Oplopende herhaalpogingen

Tijdelijke fouten worden met oplopende vertragingen opnieuw geprobeerd, tot aan de retry-limiet van het platform.

04

Foutisolatie

Een traag of onbeschikbaar eindpunt kan de levering aan ongekoppelde bestemmingen niet stoppen.

05

Automatische bescherming

Een bestemming met aanhoudende fouten kan worden gepauzeerd om de wachtrij en uw infrastructuur te beschermen.

06

Operationele zichtbaarheid

Het dashboard en de webmaster-monitoring geven inzicht in de gezondheid van de wachtrij, resultaten en recente afleverfouten.

Ondertekend en verifieerbaar

Verifieer het verzoek voordat u de gebeurtenis vertrouwt.

Elke levering bevat een tijdstempel, afleveringsidentificatie, gebeurtenistype, stabiele idempotentiesleutel en HMAC-SHA256-handtekening. Bewaar het ondertekeningsgeheim op uw server, bereken de handtekening uit de ruwe request-body en weiger ongeldige of verouderde verzoeken.

X-SMSMobileAPI-EventHet gebeurtenistype, bijvoorbeeld sms.received.X-SMSMobileAPI-DeliveryDe unieke afleveringsidentificatie voor deze bestemming.X-SMSMobileAPI-TimestampUnix-tijdstempel gebruikt bij handtekeningverificatie.X-SMSMobileAPI-SignatureHMAC-SHA256-handtekening om veilig mee te vergelijken.Idempotency-KeyStabiel event-UUID gebruikt om dubbele verwerking te voorkomen.

Consistente gebeurtenis-envelope

Één consistente JSON-envelop voor elk kanaal.

De envelop blijft voorspelbaar over SMS, oproepen, WhatsApp en e-mail. Het data-object bevat de velden die relevant zijn voor het gebeurtenistype, terwijl de topniveau-identificatoren u in staat stellen elke levering te routeren en te dedupliceren.

  • id— stabiele gebeurtenisidentificatie
  • type— exact gebeurtenistype
  • occurred_at— wanneer de activiteit plaatsvond
  • data— kanaalspecifieke informatie
{
  "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?"
  }
}

Van gebeurtenis naar zakelijk resultaat

Laat mobiele communicatie de volgende zakelijke actie in gang zetten.

CRM-gesprekken

Voeg een ontvangen SMS of WhatsApp-bericht toe aan het juiste contact en waarschuw de toegewezen eigenaar.

Herstel bij gemiste oproep

Maak een terugbeltaak aan, stuur een follow-up SMS of informeer het dienstdoende team na een gemiste oproep.

Klantenservice

Open of werk een supportticket bij wanneer een klant vanaf hun mobiel reageert.

E-commerceprocessen

Werk ordercommunicatie-workflows bij zodra een mobiel bericht is verzonden, bevestigd of mislukt.

Monitoring en waarschuwingen

Stuur afleverfouten of ongebruikelijke belactiviteit naar uw monitoring- en incidenttools.

AI- en dataworkflows

Voer geautoriseerde gebeurtenissen in classificatie-, rapportage- of assistentieworkflows zonder herhaaldelijk te pollën op de API.

Stop met pollen op wijzigingen

Polling doet herhaaldelijke verzoeken. Webhooks melden uw software zodra er iets verandert.

Polling verbruikt verzoeken, zelfs als er niets is gebeurd, en veroorzaakt vertraging tussen controles. Webhook V2 stuurt de relevante gebeurtenis naar uw endpoint, waardoor automatisering sneller, eenvoudiger en beter schaalbaar wordt.

Polling
Een nieuwe gebeurtenis?Herhaalde verzoeken · extra vertraging
WEBHOOK V2
Gebeurtenis
Waarschuw me zodra het gebeurt.Relevante gebeurtenis · onmiddellijke workflow

Veelgestelde vragen over Webhook V2

Vragen voordat u uw endpoint verbindt.

Moet ik een pollinglus bouwen?

Nee. Webhook V2 stuurt geabonneerde gebeurtenissen naar uw openbare HTTPS-endpoint. U kunt de API's nog steeds gebruiken wanneer u geschiedenis of details moet opvragen.

Kan ik meerdere webhook-URL's configureren?

Ja. U kunt meerdere bestemmingen aanmaken en voor elke bestemming een andere set gebeurtenissen kiezen, binnen de accountlimieten die in het dashboard worden weergegeven.

Hoe weet ik dat een SMS daadwerkelijk is verzonden?

Gebruik sms.api.submitted om te weten dat de taak is aangemaakt en sms.sent voor de bevestiging die door het verbonden mobiele apparaat is gerapporteerd. Behandel ze als twee verschillende operationele fasen.

Kan een webhook meer dan één keer worden afgeleverd?

Ja. Webhook V2 gebruikt 'at-least-once' levering. Sla de stabiele gebeurtenis-ID of Idempotency-Key op en negeer een levering die u al hebt verwerkt.

Wat moet mijn endpoint terugsturen?

Stuur een HTTP 2xx-respons nadat u de gebeurtenis veilig hebt geaccepteerd. De verwerking kan asynchroon binnen uw applicatie worden voortgezet.

Worden ontvangen WhatsApp-gebeurtenissen continu verzameld?

Nee. Het ophalen van ontvangen WhatsApp-berichten volgt zijn eigen op toestemming gebaseerde synchronisatieproces. Het whatsapp.received-event is beschikbaar nadat een in aanmerking komend bericht is opgehaald.

Uw mobiele gebeurtenissen. Uw software. Uw acties.

Koppel uw software nu aan de activiteit van uw echte mobiele telefoon.

Maak uw account aan of log in, open Webhook V2, voeg een openbare HTTPS-bestemming toe en kies de gebeurtenissen die belangrijk zijn voor uw workflow. Verstuur een testgebeurtenis, verifieer de handtekening en activeer uw integratie.