Cuando las entregas de webhook fallan, es importante que las personas adecuadas sean notificadas para que puedan resolver el problema rápidamente. Ahora puede configurar un Contacto técnico dedicado para su empresa, asegurando que las notificaciones relacionadas con la API se envíen al equipo responsable de mantener tus integraciones.
Visión general
El Contacto técnico permite a su empresa definir la dirección de correo electrónico que debe recibir los correos de notificación de la API, como las fallas en la entrega de webhooks.
Anteriormente, estas notificaciones se enviaban a un destinatario inferido, como el correo electrónico del socio, el propietario de la aplicación OAuth o la persona que creó la suscripción del webhook. En muchos casos, estos destinatarios ya no eran responsables de la integración, lo que provocaba que los problemas pasaran desapercibidos.
Al configurar un Contacto técnico, puede asegurarse de que las notificaciones de la API lleguen al equipo adecuado y ayudar a reducir el tiempo de inactividad causado por fallas en los webhooks que no se detectan.
Si no se configura un Contacto técnico, el proceso de notificación continúa funcionando como antes.
Cómo usar
- En su barra lateral, vaya a Ajustes
- Abra Configuración avanzada
- Seleccione Notificaciones de API
- En el campo de Contacto técnico, ingrese la dirección de correo electrónico que debe recibir las notificaciones de API
- Haga clic en Guardar
Para eliminar el Contacto técnico, borre el campo de Contacto técnico. Una vez eliminado, las notificaciones seguirán el flujo de destinatarios predeterminado.
Si no puede guardar la dirección de correo electrónico del Contacto técnico, la dirección de correo electrónico puede no estar en un formato válido. Verifique que haya ingresado una dirección de correo electrónico válida e intente guardar nuevamente.
Cómo se envían las notificaciones
Cuando una entrega de webhook falla, Factorial notifica a los destinatarios en el siguiente orden:
- Correo electrónico del socio
- Contacto técnico de la empresa (si está configurado)
- Propietario de la aplicación OAuth
- Autor de la suscripción del webhook
- Administradores/as de la empresa
Si no se ha configurado un Contacto técnico, este paso se omite y el flujo de notificación restante continúa sin cambios.
Cuando una entrega de webhook alcanza su estado final de falla después de que se han agotado todos los intentos de reintento, los/as administradores/as de la empresa continúan recibiendo la notificación como último recurso.
Consejos y mejores prácticas
- Configure una dirección de correo electrónico compartida del equipo (por ejemplo, el buzón de su equipo de Ingeniería o TI) en lugar de la dirección de correo electrónico de un individuo
- Revise regularmente el Contacto técnico configurado para asegurarse de que siga actualizado
- Utilice un buzón supervisado para que las fallas de los webhooks puedan ser atendidas lo más rápido posible
FAQ
-
¿Es obligatorio configurar un Contacto técnico?
No. Si no configuras un Contacto técnico, Factorial continúa utilizando el flujo de notificación existente sin cambios.
-
¿Quién debe configurarse como Contacto técnico?
Recomendamos utilizar un buzón compartido supervisado que sea propiedad del equipo responsable de mantener tus integraciones de API, en lugar de la dirección de correo electrónico de un/a empleado/a individual.
-
¿Este cambio afecta a las suscripciones de webhook existentes?
Sí. Una vez que se configura un Contacto técnico, se convierte en parte de la cascada de destinatarios de notificación para las fallas en la entrega de webhooks. No se requieren cambios en las suscripciones de webhook existentes.
-
¿Qué sucede si elimino el Contacto técnico?
El Contacto técnico se elimina del flujo de notificación, y las notificaciones de fallas de webhook siguen la misma cascada de destinatarios utilizada antes de que se introdujera esta función.