Cuando las entregas de webhook fallan, es importante que las personas adecuadas sean notificadas para que puedan resolver el problema rápidamente. Ahora puedes configurar un Contacto técnico dedicado para tu empresa, asegurando que las notificaciones relacionadas con la API se envíen al equipo responsable de mantener tus integraciones.
Vista general
El Contacto técnico permite a tu empresa definir la dirección de correo electrónico que debe recibir los correos de notificación de la API, como fallos en la entrega de webhook.
Anteriormente, estas notificaciones se enviaban a un destinatario inferido, como el correo del socio, el propietario de la aplicación OAuth o la persona que creó la suscripción al webhook. En muchos casos, estos destinatarios ya no eran responsables de la integración, lo que causaba que los problemas pasaran desapercibidos.
Al configurar un Contacto técnico, puedes asegurarte de que las notificaciones de la API lleguen al equipo adecuado y ayudar a reducir el tiempo de inactividad causado por fallos 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 tu barra lateral, ve a Configuración
- Abre Configuración avanzada
- Selecciona Notificaciones de API
- En el campo de Contacto técnico, ingresa la dirección de correo electrónico que debe recibir las notificaciones de API
- Haz clic en Guardar
Para eliminar el Contacto técnico, borra el campo de Contacto técnico. Una vez eliminado, las notificaciones seguirán el flujo de destinatarios predeterminado.
Si no puedes guardar la dirección de correo electrónico del Contacto técnico, la dirección de correo puede no estar en un formato válido. Verifica que has ingresado una dirección de correo válida y vuelve a intentar guardar.
Cómo se envían las notificaciones
Cuando una entrega de webhook falla, Factorial notifica a los destinatarios en el siguiente orden:
- Correo del socio
- Contacto técnico de la empresa (si está configurado)
- Propietario de la aplicación OAuth
- Autor de la suscripción al 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 fallo 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
- Configura una dirección de correo electrónico compartida del equipo (por ejemplo, el buzón de tu equipo de Ingeniería o TI) en lugar de la dirección de correo de un individuo
- Revisa regularmente el Contacto técnico configurado para asegurarte de que se mantenga actualizado
- Utiliza un buzón monitoreado para que los fallos de webhook puedan ser abordados 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 ser configurado como Contacto técnico?
Recomendamos utilizar un buzón compartido monitoreado que pertenezca al equipo responsable de mantener tus integraciones de API, en lugar de la dirección de correo de un empleado 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 fallos en la entrega de webhook. 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 fallos de webhook siguen la misma cascada de destinatarios utilizada antes de que se introdujera esta función.