Quan les entregues de webhook fallen, és important que les persones adequades siguin notificades perquè puguin resoldre el problema ràpidament. Ara pots configurar un Contacte tècnic dedicat per a la teva empresa, assegurant-te que les notificacions relacionades amb l'API s'enviïn a l'equip responsable de mantenir les teves integracions.
Visió general
El Contacte tècnic permet a la teva empresa definir l'adreça de correu electrònic que ha de rebre els correus electrònics de notificació de l'API, com ara les fallades d'entrega de webhook.
Anteriorment, aquestes notificacions s'enviaven a un destinatari inferit, com ara el correu electrònic del soci, el propietari de l'aplicació OAuth o la persona que va crear la subscripció al webhook. En molts casos, aquests destinataris ja no eren responsables de la integració, causant que els problemes passessin desapercebuts.
En configurar un Contacte tècnic, pots assegurar-te que les notificacions de l'API arribin a l'equip adequat i ajudar a reduir el temps d'inactivitat causat per fallades de webhook no detectades.
Si no es configura cap Contacte tècnic, el procés de notificació continuarà funcionant com abans.
Com utilitzar
- En la teva barra lateral, ves a Configuració
- Obre Configuració avançada
- Selecciona Notificacions de l'API
- En el camp de Contacte tècnic, introdueix l'adreça de correu electrònic que ha de rebre les notificacions de l'API
- Fes clic a Desa
Per eliminar el Contacte tècnic, esborra el camp de Contacte tècnic. Un cop eliminat, les notificacions seguiran el flux de destinataris per defecte.
Si no pots desar l'adreça de correu electrònic del Contacte tècnic, l'adreça de correu electrònic pot no estar en un format vàlid. Verifica que has introduït una adreça de correu electrònic vàlida i intenta desar-ho de nou.
Com s'envien les notificacions
Quan una entrega de webhook falla, Factorial notifica els destinataris en l'ordre següent:
- Correu electrònic del soci
- Contacte tècnic de l'empresa (si està configurat)
- Propietari de l'aplicació OAuth
- Autor de la subscripció al webhook
- Administradors/es de l'empresa
Si no s'ha configurat cap Contacte tècnic, aquest pas s'omet i el flux de notificació restant continua sense canvis.
Quan una entrega de webhook arriba al seu estat final de fallada després d'haver exhaurit totes les oportunitats de reintentar, els/les administradors/es de l'empresa continuen rebent la notificació com a últim recurs.
Consells i millors pràctiques
- Configura una adreça de correu electrònic compartida de l'equip (per exemple, la bústia del teu equip d'Enginyeria o IT) en comptes de l'adreça de correu electrònic d'un individu
- Revisa regularment el Contacte tècnic configurat per assegurar-te que es manté actualitzat
- Utilitza una bústia monitorada perquè les fallades de webhook puguin ser abordades tan ràpidament com sigui possible
FAQ
-
És obligatori configurar un Contacte tècnic?
No. Si no configures un Contacte tècnic, Factorial continuarà utilitzant el flux de notificació existent sense canvis.
-
Qui ha de ser configurat com a Contacte tècnic?
Recomanem utilitzar una bústia compartida monitorada propietat de l'equip responsable de mantenir les teves integracions d'API, en lloc de l'adreça de correu electrònic d'un empleat individual.
-
Aquest canvi afecta les subscripcions de webhook existents?
Sí. Un cop configurat un Contacte tècnic, aquest es converteix en part de la cascada de destinataris de notificació per a les fallades d'entrega de webhook. No es requereixen canvis a les subscripcions de webhook existents.
-
Què passa si elimino el Contacte tècnic?
El Contacte tècnic és eliminat del flux de notificació, i les notificacions de fallades de webhook segueixen la mateixa cascada de destinataris que s'utilitzava abans que aquesta funció fos introduïda.