Webhook

Un webhook è un meccanismo di notifica HTTP che consente a un'applicazione di inviare dati in tempo reale a un'altra quando si verifica un evento. Nella messaggistica aziendale, i webhook notificano il sistema esterno sui messaggi ricevuti, le consegne confermate o i cambiamenti di stato della conversazione.

Cos'è un webhook?

Un webhook è una chiamata HTTP inversa: invece che la vostra applicazione interroghi periodicamente un'API per conoscere le novità (polling), il servizio esterno vi notifica automaticamente in tempo reale quando si verifica un evento rilevante. Questo approccio è molto più efficiente e riduce la latenza delle notifiche a millisecondi.

Nel contesto della messaggistica aziendale, i webhook sono fondamentali per integrare piattaforme di messaggistica come WhatsApp, Telegram o SMS con sistemi CRM, ERP o applicazioni proprietarie. Senza webhook, sarebbe impossibile reagire in tempo reale ai messaggi dei clienti.

Come funzionano i webhook

Il funzionamento è semplice: lo sviluppatore registra un URL (endpoint) sulla piattaforma di messaggistica. Quando si verifica un evento (messaggio ricevuto, consegna confermata, ecc.), la piattaforma effettua una richiesta HTTP POST a quell'URL con i dati dell'evento in formato JSON. Il sistema ricevente elabora il payload e risponde con un codice HTTP 200 per confermare la ricezione.

Eventi comuni nella messaggistica

• Messaggio ricevuto – Notifica quando un cliente invia un messaggio
• Conferma di consegna – Conferma che il messaggio è arrivato al dispositivo del destinatario
• Conferma di lettura – Notifica quando il destinatario apre il messaggio
• Cambio di stato – Aggiorna quando una conversazione viene aperta, chiusa o riassegnata, essenziale per l'automazione chatbot
• Opt-out – Notifica quando un contatto annulla la propria iscrizione

Sicurezza nei webhook

I webhook devono essere adeguatamente protetti: verifica della firma digitale (HMAC-SHA256) per garantire l'autenticità del payload, utilizzo esclusivo di HTTPS, validazione dell'IP di origine dove possibile, e tempo di risposta inferiore a 10 secondi per evitare i tentativi di retry.

Webhook con SendSeven

SendSeven offre webhook per tutti i canali supportati: messaggi in arrivo, conferme di consegna, cambiamenti di stato della conversazione ed eventi di opt-out. La configurazione avviene dalla dashboard senza necessità di codice. Ogni webhook include verifica della firma e retry automatici in caso di errore. Per la guida passo-passo, consultate come configurare i webhook. Scoprite anche le funzionalità della piattaforma e la nostra guida completa all'API WhatsApp Business per capire come i webhook si integrano nell'ecosistema SendSeven.