Skip to content

Configurar un webhook ​

Acceso

Ruta: Configuraciones → Webhooks → Añadir nuevo

Visión general ​

El webhook te permite avisar a otro sistema, como un CRM o una automatización propia, siempre que ocurre un evento en ¡Hola! Suite. Así, el otro sistema recibe los datos al instante, sin necesidad de consultar ¡Hola! Suite cada cierto tiempo.

En cada evento elegido, ¡Hola! Suite envía una solicitud a la dirección (URL) que registres, con los datos del evento.

Requisitos previos ​

  • Permiso Webhooks activo en el grupo de permisos. Por defecto, viene activo solo en el grupo de administrador.
  • Una dirección (URL) del sistema de destino, lista para recibir solicitudes de tipo POST y responder con éxito.

Paso a paso ​

  1. Accede a Configuraciones → Webhooks.
  2. Haz clic en Añadir nuevo. Si aún no hay webhooks, el botón se llama Añadir nuevo webhook. La ventana Agregar Webhook se abre con tres etapas.
  3. En la etapa Informaciones principales, completa:
    • Nombre: nombre para identificar el webhook.
    • URL: la dirección que va a recibir los avisos.
    • Token (opcional): una contraseña acordada con el sistema de destino, usada para validar que el aviso vino de ¡Hola! Suite.
    • Contenido adicional para enviar (opcional): un objeto JSON con datos fijos que quieres recibir junto con cada aviso, como un identificador de tu empresa.
    • Permitir conexión no segura: actívala solo si la dirección usa un certificado HTTPS inválido o autofirmado.
  4. Haz clic para continuar. En la etapa Validar conexión, ¡Hola! Suite envía una prueba a la URL. Espera.
  5. En la etapa Desencadenantes, activa los eventos que deben disparar el webhook. Marca al menos uno:
    • Atención en movimiento
    • Respuesta a plantilla interactiva
    • Cliente inactivo durante la atención: al activarlo, elige los Departamentos monitoreados y el Tiempo máximo de inactividad, en minutos.
  6. Haz clic en Agregar Webhook.

Resultado esperado ​

El webhook aparece en la lista, con las columnas Nombre, URL y Desencadenantes. A partir de ahí, cada evento elegido genera un aviso para la URL registrada.

Si la URL no responde con éxito en la prueba, el registro vuelve a la primera etapa con el mensaje La URL no respondió como se esperaba y no pudimos conectarnos. Verifique la información proporcionada e intente nuevamente.

Configuraciones disponibles ​

Para modificar un webhook, haz clic en Acceder en la lista. La pantalla tiene las secciones Informaciones principales y Desencadenantes, que se pueden editar. El botón Probar conexión comprueba si la URL responde: ¡Conectado con exito! o No se puede conectar.

Qué dispara cada desencadenante ​

DesencadenanteCuándo se envía el aviso
Atención en movimientoCuando una atención se crea, se asume, se transfiere a un usuario o departamento o se finaliza, y cuando se agrega o quita una etiqueta, un motivo de atención o una observación. Los datos incluyen la atención, el cliente, el contacto, el agente, el departamento, el canal, el estado, el protocolo, los motivos, las observaciones y las etiquetas.
Respuesta a plantilla interactivaCuando el contacto responde a una plantilla de mensaje (template) con botones. Los datos incluyen la opción elegida, el contacto, la atención y el canal.
Cliente inactivo durante la atenciónCuando el cliente pasa sin responder el Tiempo máximo de inactividad después del último mensaje del agente, en atenciones de los Departamentos monitoreados. Si el cliente responde antes, el aviso se cancela.

Token y seguridad ​

Cuando el Token está completado, cada aviso lleva el encabezado X-Signature-SHA256, con el token cifrado en SHA-256. El sistema de destino compara ese valor con el SHA-256 del token que ya conoce para confirmar que el aviso vino de ¡Hola! Suite.

La opción Permitir conexión no segura solo hace que ¡Hola! Suite acepte certificados HTTPS inválidos o autofirmados. Las direcciones con http:// se aceptan con o sin esa opción.

Contenido adicional ​

El JSON informado en Contenido adicional para enviar se incluye en todos los avisos, junto con los datos del evento. Si el JSON está mal formado, aparece JSON inválido.

Problemas comunes ​

SíntomaQué verificar
El registro vuelve a la primera etapaLa URL no respondió con éxito a la prueba. Revisa la dirección y si el sistema de destino está en línea y acepta solicitudes POST.
Aparece URL inválidaLa dirección no tiene un formato válido. Informa la URL completa, con https:// o http://.
Aparece Selecciona al menos un desencadenanteNo se activó ningún desencadenante. Activa al menos uno.
El sistema de destino dejó de recibir algunos avisos¡Hola! Suite espera hasta 10 segundos por la respuesta y no reenvía los avisos que fallaron. Revisa si el destino estaba fuera de línea o lento en ese período.
La prueba falla con certificado autofirmadoEl botón Probar conexión no considera la opción Permitir conexión no segura. Revisa el envío real de un evento.

Buenas prácticas ​

  • Prefiere direcciones con HTTPS y completa el Token para validar el origen de los avisos.
  • Haz que el sistema de destino responda rápido y procese los datos después, para no superar el tiempo de espera de 10 segundos.
  • Como los avisos que fallan no se reenvían, trata el webhook como notificación y usa la API para verificar datos importantes.
  • Activa solo los desencadenantes que el sistema de destino usa.

Contenidos relacionados ​