Novità: i webhook sono stati aggiornati
I webhook offrono ora una configurazione migliorata, log di consegna, riproduzione degli eventi e verifica della firma. Se hai configurato i webhook prima del 31 agosto 2026, i tuoi endpoint continuano a funzionare, ma devi migrarli entro ottobre 2026. Puoi seguire i passaggi di migrazione.
I webhook ti consentono di ricevere aggiornamenti in tempo reale sui tuoi fax inviati e ricevuti direttamente da Fax.Plus. Configurando i webhook, puoi automatizzare il monitoraggio delle tue trasmissioni fax e integrare gli aggiornamenti di stato nei tuoi sistemi esistenti.
Configurazione dei webhook
- Apri il pannello Webhook:
- Accedi al tuo account Fax.Plus.
- Vai alla sezione Integrazioni in Impostazioni.
- Individua Webhook e fai clic su Gestisci.
- Aggiungi un endpoint:
- Fai clic su Aggiungi endpoint e inserisci l'URL assoluto sul tuo server che riceverà gli eventi.
- Scegli quali eventi ricevere. Iscriviti a tutti gli eventi oppure seleziona solo quelli di cui hai bisogno
dal catalogo degli eventi. -
Opzionale: filtra per numero di fax. Collega uno o più dei tuoi numeri di fax per ricevere solo eventi relativi a
quei numeri.
-
Ricevi aggiornamenti di stato
- Una volta configurato, Fax.Plus invierà un webhook all'URL specificato ogni volta che lo stato di un fax
cambia. - Il payload del webhook includerà dettagli importanti come l'ID del fax, lo stato, il timestamp e le
informazioni sul destinatario.
Nota: Se hook.id non è uguale a data.id, il fax viene reinviato. Se hook.id è uguale a data.id, significa che il fax viene inviato per la prima volta
- Una volta configurato, Fax.Plus invierà un webhook all'URL specificato ogni volta che lo stato di un fax
- Verifica la firma
- Per ogni endpoint creato, viene generato automaticamente un segreto di firma che puoi usare per validare ogni richiesta in arrivo rispetto ad esso. Scopri di più su come verificare le firme dei webhook.
- (Opzionale) Verifica gli indirizzi IP di origine:
- Puoi verificare che i webhook che ricevi provengano dal nostro elenco di IP autorizzati:
- 52.215.16.239
- 54.216.8.72
- 63.33.109.123
- 2a05:d028:17:8000::/56
- Puoi verificare che i webhook che ricevi provengano dal nostro elenco di IP autorizzati:
Risoluzione dei problemi e monitoraggio
- Log e osservabilità: nel pannello dei webhook, puoi vedere ogni evento e se è stato consegnato con successo o meno.
- Tentativi automatici: in caso di errore di consegna, i webhook vengono automaticamente reinviati.
- Riproduzione: puoi anche avviare tentativi manuali dal pannello, oppure riprodurre eventi passati in un intervallo di tempo scelto.