Saltar al contenido
AurionAI

Webhooks de notificación

4 min de lecturaPor Emmanuel Yazbeck

Un webhook de notificación envía eventos de notificación de AurionAI a otro sistema, por ejemplo una herramienta de chat. AurionAI publica cada evento como un cuerpo JSON en la dirección que introduzcas.

Disponibilidad: Perfiles Helpdesk y AI Voice + Helpdesk. Solo administradores.

Requisitos previos

  • Tienes el rol Propietario o Administrador. Los demás usuarios ven Acceso denegado.
  • Tu organización utiliza el perfil Helpdesk o el perfil AI Voice + Helpdesk.
  • Una dirección HTTPS pública que acepte solicitudes POST con un cuerpo JSON.

Abrir los webhooks de notificación

  1. En la barra lateral, selecciona Configuración.
  2. Abre la categoría Sistema.
  3. Selecciona Webhooks de notificación.

La página de Webhooks de notificación con la lista de webhooks.

Añadir un webhook

  1. Selecciona Añadir webhook.
  2. En Nombre, escribe un nombre.
  3. En URL, escribe la dirección. Debe comenzar con https://.
  4. Opcional: en Secreto (opcional), escribe un secreto. AurionAI firmará entonces cada solicitud. Déjalo vacío para enviar solicitudes sin firmar.
  5. Elige los eventos:
    • Para recibir todos los eventos de notificación, activa Suscribirse a todos los eventos.
    • De lo contrario, selecciona los eventos en la lista.
  6. Selecciona Crear.

Aparece el mensaje Webhook creado. Un webhook nuevo está Activado.

Probar el webhook

  1. En el webhook, selecciona Probar.
  2. En el cuadro de diálogo ¿Enviar un payload de prueba?, selecciona Enviar prueba.

AurionAI envía un evento webhook.test de inmediato. Aparece el mensaje Payload de prueba enviado correctamente o Error al enviar el payload de prueba.

Verificar la firma

Cuando el webhook tiene un secreto, cada solicitud incluye dos cabeceras adicionales:

  • X-Webhook-Timestamp: la hora de la solicitud, en segundos desde el 1 de enero de 1970 (UTC).
  • X-Webhook-Signature: sha256= seguido de la firma.

Para comprobar una solicitud, calcula un HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo sin procesar, con tu secreto. Escribe el resultado en hexadecimal. Debe coincidir con la parte que sigue a sha256=.

Editar, deshabilitar o eliminar un webhook

  • Para modificar un webhook, selecciona Editar webhook, cambia los campos y selecciona Guardar. Deja el secreto vacío para conservarlo, o selecciona Eliminar secreto para enviar solicitudes sin firmar.
  • Para detener las entregas durante un tiempo, abre Editar webhook y cambia el interruptor a Desactivado. Luego guarda.
  • Para eliminar un webhook, selecciona Eliminar. En el cuadro de diálogo ¿Eliminar este webhook?, selecciona Eliminar webhook. Esto también elimina su historial de entregas y su secreto. Esta acción no se puede deshacer.
  • Para ver las entregas anteriores, selecciona Historial en el webhook. Cada línea muestra Entregado, Fallido o Omitido, con el motivo del fallo.

Resultado

AurionAI envía cada evento seleccionado cuando se produce. Si tu dirección no responde, o responde con un estado 5xx, AurionAI lo intenta de nuevo de inmediato, hasta un máximo de tres intentos en total. Una respuesta 4xx es definitiva: AurionAI no vuelve a intentarlo.

Si algo va mal

  • La URL debe empezar por https://. Comienza la dirección con https://.
  • Los endpoints de metadatos en la nube siempre están bloqueados. o un mensaje que indica que una dirección IP está en un rango bloqueado. AurionAI no envía webhooks a direcciones privadas o internas. Usa una dirección pública.
  • Un mensaje indica que la resolución DNS ha fallado. El nombre de host no existe o no tiene registro DNS. Comprueba la dirección.
  • Seleccione al menos un evento o elija «Suscribirse a todos los eventos». Selecciona al menos un evento o activa Suscribirse a todos los eventos.
  • Error al enviar el payload de prueba Lee el motivo, el estado HTTP y el número de intentos en el mensaje. Comprueba que tu receptor está en línea y responde con un estado 2xx.
  • Este webhook está desactivado Habilita primero el webhook. Si seleccionas Enviar de todos modos, AurionAI solo registra un intento omitido.
  • Una entrega muestra Omitido. El webhook estaba deshabilitado o la dirección no superó la comprobación de seguridad antes del envío. Lee el motivo en el historial.
  • No se pudieron cargar los webhooks o No se pudieron cargar los eventos de notificación Selecciona Reintentar.

Artículos relacionados

¿Sigue con dudas? Envíe una solicitud o .