Copri SMS, chiamate, WhatsApp e email con nomi evento precisi.
WEBHOOK V2 · Ogni evento mobile recapitato al tuo software
Trasforma ogni evento del tuo mobile connesso in un'azione immediata.
SMSMobileAPI Webhook V2 invia eventi HTTPS strutturati alle tue applicazioni quando un SMS viene inviato, consegnato, non riuscito o ricevuto, quando una chiamata mobile viene persa, in entrata o in uscita, e quando si verificano attività supportate di WhatsApp o email. Configura tutto visivamente dalla tua dashboard—senza necessità di polling.
Leggi la documentazione di APIScegli gli eventi che ogni destinazione riceve. Testa, metti in pausa, monitora e ruota il suo segreto di firma da un unico spazio di lavoro.
SMSChiamataWAEmail
JSON firmato
SMSMobileAPIWebhookV2Coda di eventi persistente
In tempo reale
HTTPS POST
C.AssistenzaAutomazioneAnalisi
Invia gruppi di eventi diversi a diverse destinazioni HTTPS.
Verifica ogni richiesta usando la sua firma HMAC-SHA256 e il timestamp.
I guasti temporanei delle destinazioni vengono ritentati senza bloccare altri account.
Come funziona WEBHOOK V2
Da un evento reale del tuo dispositivo mobile alla tua applicazione in tre passaggi chiari.
Il tuo mobile connesso e i servizi SMSMobileAPI generano eventi operativi. Webhook V2 inserisce ogni evento idoneo in una coda di consegna persistente e invia un payload JSON firmato all'HTTPS URL che hai selezionato.
- 1
Si verifica un evento
Un messaggio viene inviato, un dispositivo mobile invia o riceve un SMS, lo stato di una chiamata cambia, oppure viene registrata un'attività supportata di WhatsApp o email.
- 2
Webhook V2 lo instrada
SMSMobileAPI crea un ID evento stabile e mette in coda una consegna solo per le destinazioni iscritte a quel tipo di evento.
- 3
Il tuo software reagisce
Il tuo endpoint pubblico HTTPS verifica la firma, memorizza l'ID evento e avvia il tuo flusso di lavoro CRM, di assistenza, di allerta o di automazione.
15 tipi di evento precisi
Sottoscrivi solo gli eventi mobili necessari al tuo flusso di lavoro.
Una destinazione può ricevere tutto, oppure puoi separare sistemi di produzione, analisi e avvisi operativi. Ogni evento ha un nome preciso così la tua applicazione può gestirlo in modo prevedibile.
SMS
5sms.api.submittedSMS inviato tramite API
Una richiesta API ha creato un job di invio SMS. Utile per confermare che la richiesta è entrata nella piattaforma.
sms.sentSMS inviato
Il mobile connesso ha confermato l'operazione di invio di SMS.
sms.failedSMS non riuscito
Il dispositivo mobile connesso ha restituito un errore di invio SMS.
sms.receivedSMS ricevuto
Un dispositivo mobile connesso ha sincronizzato un SMS in arrivo.
sms.mobile.sentSMS inviato dal dispositivo mobile
Un SMS è stato inviato manualmente dal dispositivo mobile connesso.
Chiamate
3call.missedChiamata persa
Una chiamata persa è stata sincronizzata da un dispositivo mobile connesso.
call.incomingChiamata in arrivo
Una chiamata in arrivo è stata sincronizzata da un dispositivo mobile connesso.
call.outgoingChiamata in uscita
Una chiamata in uscita è stata sincronizzata da un dispositivo mobile connesso.
whatsapp.submittedWhatsApp inviato
È stato creato un job di invio WhatsApp.
whatsapp.sentWhatsApp inviato
L'ambiente WhatsApp connesso ha confermato che il messaggio è stato inviato.
whatsapp.failedWhatsApp fallito
L'operazione di invio WhatsApp non è riuscita.
whatsapp.receivedWhatsApp ricevuto
Un messaggio WhatsApp è stato recuperato dopo che l'account ha richiesto la sincronizzazione.
whatsapp.voice.transcribedMessaggio vocale trascritto
Un messaggio vocale WhatsApp recuperato e idoneo è stato convertito in testo utilizzabile.
email.sentEmail inviata
Una richiesta di invio email è stata creata da SMSMobileAPI.
email.receivedEmail ricevuta
Una casella connessa ha ricevuto un'email.
Configura tutto visivamente
Gestione professionale dei webhook senza modificare file di configurazione.
Apri Webhook V2 nella dashboard SMSMobileAPI, aggiungi un nome per la destinazione e un pubblico HTTPS URL, seleziona gli eventi, poi salva. La dashboard ti fornisce i controlli necessari per l'operatività quotidiana e la risoluzione dei problemi.
Destinazioni multiple
Crea destinazioni dedicate per il tuo CRM, il monitoraggio, l'analisi o le applicazioni per i clienti.
Filtri eventi
Seleziona esattamente quali eventi SMS, di chiamata, WhatsApp e email riceve ciascun URL.
Test di consegna
Invia un evento di test controllato prima di affidarti alla destinazione in produzione.
Metti in pausa e riattiva
Ferma una destinazione istantaneamente senza eliminare la sua configurazione.
Rotazione del segreto
Genera un nuovo segreto di firma quando il tuo processo di sicurezza lo richiede.
Attività di consegna
Esamina le consegne in coda, quelle consegnate, in riprova e quelle non riuscite, con informazioni sui tentativi e sullo stato HTTP.
Webhook V23 attive
CRM di produzione
https://crm.example.com/hooks/mobileAttivosms.receivedcall.missedwhatsapp.received
Avvisi operativi
https://ops.example.com/eventsAttivosms.failedwhatsapp.failed
Affidabilità per progettazione
Progettato per una consegna affidabile e indipendente.
La consegna via webhook è asincrona. Il flusso mobile non attende la risposta di un URL di terze parti e una destinazione in errore non blocca un altro cliente o destinazione.
Coda persistente
Gli eventi idonei vengono memorizzati prima della consegna, in modo che un'interruzione temporanea del destinatario non cancelli l'evento.
Consegna almeno una volta
Una consegna può essere riprovata. Conserva l'ID dell'evento ed elaboralo una sola volta nella tua applicazione.
Ritenti progressivi
I guasti temporanei vengono ritentati con ritardi crescenti, fino al limite di tentativi della piattaforma.
Isolamento dei guasti
Un endpoint lento o non disponibile non può interrompere le consegne verso destinazioni non correlate.
Protezione automatica
Una destinazione con errori persistenti può essere messa in pausa per proteggere la coda e la tua infrastruttura.
Visibilità operativa
La dashboard e il monitoraggio webmaster mostrano lo stato della coda, i risultati e gli errori di consegna recenti.
Firmato e verificabile
Verifica la richiesta prima di accettare l'evento.
Ogni consegna include un timestamp, un identificatore di consegna, il tipo di evento, una chiave di idempotenza stabile e la firma HMAC-SHA256. Conserva il segreto di firma sul tuo server, calcola la firma dal corpo grezzo della richiesta e rifiuta le richieste non valide o scadute.
X-SMSMobileAPI-EventIl tipo di evento, ad esempio sms.received.X-SMSMobileAPI-DeliveryL'identificatore univoco di consegna per questa destinazione.X-SMSMobileAPI-TimestampTimestamp Unix usato per la verifica della firma.X-SMSMobileAPI-SignatureFirma HMAC-SHA256 da confrontare in modo sicuro.Idempotency-KeyUUID stabile dell'evento usato per prevenire l'elaborazione duplicata.Struttura evento coerente
Un'unica struttura JSON coerente per ogni canale.
La struttura rimane prevedibile attraverso SMS, le chiamate, WhatsApp e l'email. L'oggetto data contiene i campi rilevanti per il tipo di evento, mentre gli identificatori a livello superiore permettono di instradare e deduplicare ogni consegna.
id— identificatore stabile dell'eventotype— tipo di evento esattooccurred_at— quando l'attività è avvenutadata— informazioni specifiche del canale
{
"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?"
}
}Dall'evento al risultato aziendale
Fai sì che la comunicazione mobile attivi la prossima azione aziendale.
Conversazioni CRM
Aggiungi un messaggio SMS o WhatsApp ricevuto al contatto corretto e notifica il responsabile assegnato.
Recupero chiamate perse
Crea un'attività di richiamata, invia un SMS di follow-up o avvisa il team di reperibilità dopo una chiamata persa.
Assistenza clienti
Apri o aggiorna un ticket di assistenza quando un cliente risponde dal proprio cellulare.
Operazioni e-commerce
Aggiorna i workflow di comunicazione degli ordini dopo che un messaggio mobile è stato inviato, confermato o è fallito.
Monitoraggio e avvisi
Invia i fallimenti di consegna o attività di chiamata anomale ai tuoi strumenti di osservabilità e gestione degli incidenti.
Workflow di IA e dati
Alimenta eventi autorizzati nei workflow di classificazione, reportistica o assistenza senza dover interrogare ripetutamente il API.
Smetti di interrogare per rilevare le modifiche
Il polling interroga ripetutamente. I webhook notificano il tuo software quando qualcosa cambia.
Il polling consuma richieste anche quando non è successo nulla e introduce ritardi tra i controlli. Webhook V2 invia l'evento rilevante al tuo endpoint, rendendo l'automazione più veloce, semplice e scalabile.
C'è un nuovo evento?Richieste ripetute · ritardo aggiuntivo
Evento
Avvisami quando si verifica.Evento rilevante · workflow immediatoFAQ Webhook V2
Domande prima di collegare il tuo endpoint.
Devo implementare un ciclo di polling?＋
No. Webhook V2 invia gli eventi sottoscritti al tuo endpoint pubblico HTTPS. Puoi comunque usare le API quando devi interrogare lo storico o i dettagli.
Posso configurare più URL webhook?＋
Sì. Puoi creare più destinazioni e scegliere un set diverso di eventi per ciascuna, entro i limiti dell'account mostrati nella dashboard.
Come faccio a sapere se un SMS è stato effettivamente inviato?＋
Usa sms.api.submitted per sapere che il job è stato creato e sms.sent per la conferma segnalata dal dispositivo mobile connesso. Considerali come due fasi operative distinte.
Un webhook può essere consegnato più di una volta?＋
Sì. Webhook V2 usa una consegna at-least-once (almeno una volta). Salva l'ID evento stabile o Idempotency-Key e ignora una consegna che hai già elaborato.
Cosa deve restituire il mio endpoint?＋
Restituisci una risposta HTTP 2xx dopo aver accettato in sicurezza l'evento. L'elaborazione può proseguire in modo asincrono all'interno della tua applicazione.
Gli eventi WhatsApp ricevuti vengono raccolti continuamente?＋
No. Il recupero dei messaggi ricevuti da WhatsApp segue un proprio processo di sincronizzazione basato sul consenso. L'evento whatsapp.received è disponibile dopo che un messaggio idoneo è stato recuperato.
I tuoi eventi mobili. Il tuo software. Le tue azioni.
Collega subito il tuo software all'attività del tuo dispositivo mobile reale.
Crea il tuo account o accedi, apri Webhook V2, aggiungi una destinazione pubblica HTTPS e scegli gli eventi rilevanti per il tuo workflow. Invia un evento di prova, verifica la sua firma e attiva l'integrazione.
