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

Chi può usare questa funzione?

Disponibile con il piano Enterprise.

Accessibile a Proprietari e Amministratori nell'app web.

Novità: aggiornamento dei webhook 
I webhook ora offrono una configurazione migliore, log di consegna, riproduzione degli eventi e verifica della firma. Se hai configurato i webhook prima del 31 agosto 2026, gli endpoint continuano a funzionare, ma devi migrarli entro il 15 gennaio 2027. Puoi seguire la procedura di migrazione.

I webhook permettono di ricevere aggiornamenti in tempo reale sui fax inviati e ricevuti direttamente da Fax.Plus. Configurando i webhook, è possibile automatizzare il monitoraggio delle trasmissioni fax e integrare gli aggiornamenti di stato nei sistemi già in uso.

Riferimento per sviluppatori: per tutti i dettagli tecnici, inclusi tipi di evento, struttura del payload e verifica della firma, consulta la documentazione dell'API di Fax.Plus sui webhook.

Configurazione dei webhook

  1. Apri il pannello 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 di cui hai bisogno 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, il fax viene inviato di nuovo. Se hook.id è uguale a data.id, 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 inviati di nuovo automaticamente.
  • Riproduzione: dal pannello puoi anche avviare nuovi tentativi manuali oppure riprodurre qualsiasi evento passato in un intervallo di tempo a tua scelta.
Questo articolo ti è stato utile?
Utenti che ritengono sia utile: 0 su 1
Altri articoli in questa sezione