Tutto ciò che vale la pena sapere, niente di superfluo.
Quali eventi offre
I due tipi più comuni sono le conferme di consegna (DLR), che indicano se ogni messaggio ha raggiunto il dispositivo e perché non è andato a buon fine, e i messaggi in entrata, che consentono di creare flussi bidirezionali e di gestire i messaggi STOP. Vedi /answers/what-is-dlr e /answers/what-is-mo-vs-mt.
Perché la spinta batte i sondaggi
L'interrogazione di un'API per lo stato comporta uno spreco di richieste e aggiunge latenza; un webhook invia l'evento nel momento stesso in cui si verifica, consentendo ai tentativi di invio dell'OTP, al supporto del routing e alle analisi di reagire in tempo reale. Vedi /developers/webhooks.
Verifica e proteggilo
Poiché chiunque può inviare richieste POST a un URL pubblico, firmare i payload dei webhook (ad esempio con HMAC-SHA256) e verificare la firma prima di considerare attendibile un evento, e servire sempre l'endpoint tramite HTTPS. Vedi /answers/hmac-sha256-dlr-signing e /tools/webhook-signature-validator.
Rendilo resiliente
Restituisci un codice di stato rapido 2xx ed elabora in modo asincrono, aspettati tentativi di ripetizione e occasionali duplicati (quindi gestisci gli eventi in modo idempotente) e monitora gli errori in modo da non perdere mai silenziosamente un evento di consegna. Vedi /developers/webhooks.