Webhook

Webhook in tempo reale per ogni evento

Ricevi conferme di consegna, messaggi in arrivo e cambi di stato istantaneamente. Un unico endpoint per WhatsApp, SMS ed Email.

Inizia gratis Documentazione API

Webhook Manager: ricevi ogni evento in tempo reale

Il Webhook Manager di Chat API ti permette di registrare un endpoint HTTPS sul tuo server e ricevere notifiche istantanee per ogni evento generato dai tuoi canali di messaggistica: messaggi in arrivo su WhatsApp, conferme di consegna, letture, aggiornamenti di stato SMS, aperture email e molto altro.

A differenza del polling tradizionale, con i webhook non devi interrogare continuamente le API per sapere se è successo qualcosa. L'evento arriva direttamente al tuo server in millisecondi, con un payload JSON strutturato e una firma HMAC SHA-256 per verificare l'autenticità di ogni richiesta.

Il sistema è progettato per la massima affidabilità: in caso di errore del tuo endpoint, il Webhook Manager ritenta automaticamente la consegna con backoff esponenziale, garantendo che nessun evento vada perso. Ogni tentativo viene registrato nel log con payload, status code e tempo di risposta, rendendo il debugging semplice e veloce.

Funzionalità

Tutto ciò che serve per gestire i webhook

Un sistema robusto e affidabile per ricevere eventi in tempo reale da tutti i tuoi canali.

Consegna in tempo reale

Eventi consegnati istantaneamente al tuo endpoint non appena si verificano. Nessun polling, nessun ritardo.

Retry automatici

Tentativi automatici con backoff esponenziale in caso di errore. Nessun evento perso, mai.

Filtro eventi

Iscriviti solo agli eventi che ti servono. Riduci il rumore e ottimizza il tuo server.

Firma HMAC

Ogni webhook è firmato con HMAC SHA-256. Verifica l'autenticità di ogni richiesta in arrivo.

Log e debugging

Log dettagliati per ogni evento inviato. Visualizza payload, status code e tempi di risposta.

Multi-canale

Eventi unificati da WhatsApp, SMS ed Email in un unico endpoint. Un solo formato, tre canali.

Come funziona

Configurazione in 3 passaggi

Dall'endpoint alla ricezione degli eventi in pochi minuti.

1

Setup

Configura endpoint

Registra l'URL del tuo server che riceverà gli eventi. Supporta HTTPS con verifica del certificato.

2

Filtra

Seleziona gli eventi

Scegli quali tipi di eventi ricevere: messaggi in arrivo, conferme di consegna, cambi di stato e altro.

3

Live

Ricevi in tempo reale

Gli eventi arrivano al tuo endpoint in millisecondi con payload JSON completo e firma HMAC.

Esempio payload

Payload JSON strutturato

Ogni evento webhook viene consegnato con un payload JSON chiaro e consistente. Facile da parsare, facile da integrare.

message.receivedmessage.deliveredmessage.readmessage.failedtemplate.approved
POST → your-server.com/webhook 
{
  "event": "message.received",
  "channel": "whatsapp",
  "timestamp": "2026-03-14T10:30:00Z",
  "data": {
    "from": "+39123456789",
    "message": "Hello!",
    "type": "text"
  }
}

99.99%

Uptime

<200ms

Consegna

50M+

Eventi / mese

3

Canali

Domande frequenti sul Webhook Manager

Che cosa è un webhook e come funziona?
Un webhook è una notifica HTTP che il server di Chat API invia al tuo endpoint ogni volta che si verifica un evento (es. messaggio ricevuto, consegna confermata). Il tuo server non deve fare nulla di speciale: basta esporre un URL HTTPS che accetti richieste POST in formato JSON.
Come posso verificare che le richieste webhook siano autentiche?
Ogni richiesta webhook include un header di firma calcolato con HMAC SHA-256 usando la chiave segreta del tuo account. Confronta la firma ricevuta con quella calcolata lato tuo: se corrispondono, la richiesta è autentica e non è stata alterata in transito.
Cosa succede se il mio endpoint non è disponibile?
Il Webhook Manager ritenta automaticamente la consegna fino a 5 volte con backoff esponenziale (5s, 25s, 125s, 625s, 3125s). Se tutti i tentativi falliscono, l'evento viene registrato come non consegnato nel log di sistema, dove puoi analizzarlo e attivare una riconsegna manuale.
Posso filtrare gli eventi per ricevere solo quelli che mi interessano?
Sì. Durante la configurazione del webhook puoi selezionare esattamente quali tipi di eventi vuoi ricevere: message.received, message.delivered, message.read, message.failed, template.approved e altri. Questo riduce il traffico verso il tuo server e semplifica la logica di elaborazione.
Il Webhook Manager funziona con tutti i canali?
Sì. Un singolo endpoint riceve eventi da tutti e tre i canali: WhatsApp, SMS ed email. Il payload JSON include sempre un campo 'channel' che identifica la fonte dell'evento, permettendoti di gestire tutti i canali con un'unica logica applicativa.
Webhook Manager

Pronto a ricevere eventi in tempo reale?

Configura il tuo primo webhook in pochi minuti. Nessuna carta di credito richiesta.

Inizia gratis Parla con il team vendite