Omvat SMS, oproepen, WhatsApp en e-mail met nauwkeurige gebeurtenisnamen.
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-documentatieKies welke events elke bestemming ontvangt. Test, pauzeer, bewaak en roteer de ondertekeningssleutel vanuit één workspace.
Stuur verschillende eventgroepen naar verschillende HTTPS-bestemmingen.
Verifieer elk verzoek met de HMAC-SHA256-handtekening en tijdstempel.
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
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
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
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
5sms.api.submittedSMS ingediend via API
Een API-verzoek heeft een SMS verzendtaak aangemaakt. Handig om te bevestigen dat het verzoek in het platform is aangekomen.
sms.sentSMS verzonden
Het gekoppelde mobiele apparaat heeft de SMS-verzending bevestigd.
sms.failedSMS mislukt
De gekoppelde mobiele telefoon gaf een verzendfout: SMS.
sms.receivedSMS ontvangen
Een gekoppelde mobiele telefoon synchroniseerde een binnenkomende SMS.
sms.mobile.sentSMS verzonden vanaf mobiel
Een SMS werd handmatig vanaf de gekoppelde mobiele telefoon verzonden.
Oproepen
3call.missedGemiste oproep
Een gemiste oproep werd vanuit een gekoppelde mobiele telefoon gesynchroniseerd.
call.incomingBinnenkomende oproep
Een binnenkomende oproep werd vanuit een gekoppelde mobiele telefoon gesynchroniseerd.
call.outgoingUitgaande oproep
Een uitgaande oproep werd vanuit een gekoppelde mobiele telefoon gesynchroniseerd.
whatsapp.submittedWhatsApp ingediend
Er is een verzendtaak voor WhatsApp aangemaakt.
whatsapp.sentWhatsApp verzonden
De gekoppelde WhatsApp-omgeving heeft bevestigd dat het bericht is verzonden.
whatsapp.failedWhatsApp mislukt
De verzendactie voor WhatsApp is mislukt.
whatsapp.receivedWhatsApp ontvangen
Een WhatsApp-bericht werd opgehaald nadat het account synchronisatie had aangevraagd.
whatsapp.voice.transcribedSpraakbericht getranscribeerd
Een opgehaald WhatsApp-spraakbericht dat in aanmerking kwam, werd omgezet in bruikbare tekst.
email.sentE-mail verzonden
Een verzendverzoek voor e-mail werd aangemaakt door SMSMobileAPI.
email.receivedE-mail ontvangen
Een gekoppelde mailbox ontving een e-mail.
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.
https://crm.example.com/hooks/mobileActiefsms.receivedcall.missedwhatsapp.received
https://ops.example.com/eventsActiefsms.failedwhatsapp.failed
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.
Persistente wachtrij
In aanmerking komende gebeurtenissen worden opgeslagen vóór levering, zodat tijdelijke uitval van de ontvanger het evenement niet verwijdert.
Aflevering minstens eenmaal
Een aflevering kan worden herhaald. Sla de event-ID op en verwerk deze slechts één keer in uw eigen applicatie.
Oplopende herhaalpogingen
Tijdelijke fouten worden met oplopende vertragingen opnieuw geprobeerd, tot aan de retry-limiet van het platform.
Foutisolatie
Een traag of onbeschikbaar eindpunt kan de levering aan ongekoppelde bestemmingen niet stoppen.
Automatische bescherming
Een bestemming met aanhoudende fouten kan worden gepauzeerd om de wachtrij en uw infrastructuur te beschermen.
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 gebeurtenisidentificatietype— exact gebeurtenistypeoccurred_at— wanneer de activiteit plaatsvonddata— 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.
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.
