Come posso usare i webhook per controllare lo stato dei fax inviati o ricevuti?

I webhook consentono di ricevere aggiornamenti in tempo reale sui fax inviati e ricevuti direttamente da Fax.Plus. Configurando i webhook, puoi automatizzare il monitoraggio delle trasmissioni di fax e integrare gli aggiornamenti di stato nei tuoi sistemi esistenti.

Configurazione dei webhook

1. Apri il riquadro Webhook:
   • Accedi al tuo account Fax.Plus.
   • Vai alla sezione Integrazioni in Impostazioni.
   • Individua Webhook e fai clic su Gestisci.
2. Aggiungi un endpoint:
   • Fai clic su Aggiungi endpoint e inserisci l'URL assoluto sul tuo server che riceverà gli eventi.
   • Scegli quali eventi ricevere. Puoi iscriverti a tutti gli eventi oppure selezionare solo quelli che ti servono dal
     catalogo degli eventi.
   • Facoltativo: filtra per numero di fax. Associa uno o più dei tuoi numeri di fax per ricevere solo gli eventi relativi a
     quei numeri.

3. Ricevi gli aggiornamenti di stato

   • Una volta completata la configurazione, 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 è diverso da data.id, è in corso un nuovo tentativo di invio del fax. Se hook.id è uguale a data.id, significa che il fax viene inviato per la prima volta

4. Verifica la firma
   • Per ogni endpoint creato viene generato automaticamente un segreto di firma che puoi usare per convalidare ogni richiesta in arrivo. Scopri di più sulla verifica delle firme dei webhook.
5. (Facoltativo) Verifica gli indirizzi IP di origine:
   • Puoi verificare che i webhook ricevuti provengano dal nostro elenco di IP autorizzati:
     • 52.215.16.239
     • 54.216.8.72
     • 63.33.109.123
     • 2a05:d028:17:8000::/56

Risoluzione dei problemi e monitoraggio

• Log e osservabilità: nel pannello dei webhook puoi vedere ogni evento e se è stato consegnato correttamente o meno.
• Nuovi tentativi: in caso di mancata consegna, i webhook vengono rinviati automaticamente.
• Riproduzione: puoi anche avviare nuovi tentativi manuali dal pannello oppure riprodurre qualsiasi evento passato in un intervallo di tempo a tua scelta.