Quando le consegne dei webhook falliscono, è importante che le persone giuste vengano avvisate affinché possano risolvere rapidamente il problema. Ora puoi configurare un Contatto tecnico dedicato per la tua azienda, assicurando che le notifiche relative all'API vengano inviate al team responsabile della manutenzione delle tue integrazioni.
Panoramica
Il Contatto tecnico consente alla tua azienda di definire l'indirizzo email che dovrebbe ricevere le email di notifica dell'API, come ad esempio i fallimenti nelle consegne dei webhook.
In precedenza, queste notifiche venivano inviate a un destinatario inferito, come l'email del partner, il proprietario dell'applicazione OAuth o la persona che ha creato l'iscrizione al webhook. In molti casi, questi destinatari non erano più responsabili per l'integrazione, causando che i problemi passassero inosservati.
Configurando un Contatto tecnico, puoi garantire che le notifiche API raggiungano il team appropriato e aiutare a ridurre i tempi di inattività causati da fallimenti nei webhook non notati.
Se non è configurato alcun Contatto tecnico, il processo di notifica continua a funzionare come prima.
Come utilizzare
- Nella tua barra laterale, vai su Impostazioni
- Apri Configurazione avanzata
- Seleziona Notifiche API
- Nel campo Contatto tecnico, inserisci l'indirizzo email che dovrebbe ricevere le notifiche API
- Fai clic su Salva
Per rimuovere il Contatto tecnico, cancella il campo Contatto tecnico. Una volta rimosso, le notifiche seguiranno il flusso di destinatari predefinito.
Se non riesci a salvare l'indirizzo email del Contatto tecnico, l'indirizzo email potrebbe non essere in un formato valido. Verifica di aver inserito un indirizzo email valido e prova a salvare di nuovo.
Come vengono inviate le notifiche
Quando una consegna di un webhook fallisce, Factorial notifica i destinatari nel seguente ordine:
- Email del partner
- Contatto tecnico dell'azienda (se configurato)
- Proprietario dell'applicazione OAuth
- Autore dell'iscrizione al webhook
- Amministratori dell'azienda
Se non è stato configurato alcun Contatto tecnico, questo passaggio viene saltato e il flusso di notifica rimanente continua invariato.
Quando una consegna di un webhook raggiunge il suo stato finale di fallimento dopo che tutti i tentativi di ripristino sono stati esauriti, gli amministratori dell'azienda continuano a ricevere la notifica come ultima risorsa.
Consigli e migliori pratiche
- Configura un indirizzo email di team condiviso (ad esempio, la casella di posta del tuo team di Ingegneria o IT) anziché l'indirizzo email di un singolo individuo
- Rivedi regolarmente il Contatto tecnico configurato per assicurarti che rimanga aggiornato
- Utilizza una casella di posta monitorata in modo che i fallimenti dei webhook possano essere affrontati il più rapidamente possibile
FAQ
-
È obbligatorio configurare un Contatto tecnico?
No. Se non configuri un Contatto tecnico, Factorial continua a utilizzare il flusso di notifica esistente senza alcuna modifica.
-
Chi dovrebbe essere configurato come Contatto tecnico?
Consigliamo di utilizzare una casella di posta condivisa monitorata, di proprietà del team responsabile della manutenzione delle tue integrazioni API, piuttosto che l'indirizzo email di un singolo dipendente.
-
Questa modifica influisce sulle iscrizioni ai webhook esistenti?
Sì. Una volta configurato un Contatto tecnico, diventa parte della cascata di destinatari di notifica per i fallimenti nella consegna dei webhook. Non sono richieste modifiche alle iscrizioni ai webhook esistenti.
-
Cosa succede se rimuovo il Contatto tecnico?
Il Contatto tecnico viene rimosso dal flusso di notifica e le notifiche di fallimento dei webhook seguono la stessa cascata di destinatari utilizzata prima dell'introduzione di questa funzione.