Tus conversaciones con clientes no viven solas. Un chat nuevo debería llegar a tu CRM, una conversación terminada debería actualizar un registro y un contacto que cambió no debería obligar a nadie a copiar campos a mano al final del día. En HellouOne, Ajustes, Integraciones es el lugar donde se reúnen esas conexiones, y los webhooks son la más simple de ellas: un flujo en vivo de lo que pasa en tu cuenta, enviado al sistema que elijas, en el momento en que ocurre. Este artículo explica qué contiene la página de Integraciones, cómo crear un webhook y cómo comprobar que un envío realmente vino de HellouOne.
Qué vive en Integraciones
Ajustes, Integraciones reúne los servicios que HellouOne puede conectar a tu cuenta. Qué tarjetas ves depende de tu plan y de lo que el equipo de Hellou haya habilitado para ti. Una cuenta con telefonía, por ejemplo, ve la Integración Porta PBX, que activa el marcador, el clic para llamar, el historial de llamadas y la sincronización de contactos. Una distinción evita confusiones. Las conexiones de tu agente de IA con tu CRM, tu tienda o tu agenda no están en esta página. Esas se configuran en LIA, Marketplace, Conectores, en la guía sobre conectar servicios a tu agente de IA. La página de Integraciones trata de tu cuenta como un todo, mientras que los conectores tratan de lo que un agente de IA concreto puede usar mientras habla con clientes. Separar los dos te ayuda a diagnosticar en el lugar correcto: el comportamiento de la cuenta aquí, las herramientas del agente allá.
Qué hace un webhook
Un webhook envía a otro sistema, tu CRM, un flujo de automatización, un almacén de datos, cada evento de tu cuenta en cuanto ocurre: una conversación nueva, un mensaje, un contacto actualizado. HellouOne hace una petición POST con el evento en JSON a la dirección que indiques. Ese modelo de envío cambia el trabajo. En lugar de consultar una API preguntando qué cambió, tu sistema reacciona cuando algo pasa. El primer mensaje de un lead puede crear o actualizar el registro en el CRM mientras la conversación sigue abierta. Un evento de mensaje puede alimentar tus informes sin una exportación nocturna. Un contacto actualizado puede evitar que dos libretas de direcciones se vayan separando. Nada de esto necesita a una persona mirando un panel y volviendo a escribir lo que ve.
Crear un webhook, paso a paso
Crearlo toma unos minutos. Abre Configuración, Integraciones, Webhooks, y pulsa Añadir nuevo webhook. Pega la dirección que recibirá los eventos. Debe ser https y accesible desde internet. Después marca los eventos que necesitas; solo aparecen los que incluye tu plan. Guarda, y los envíos empiezan para los eventos que seleccionaste. Elige los eventos con intención. Suscribirte a todo porque podría servir crea ruido que tu sistema receptor tiene que absorber, guardar y proteger. Empieza por los eventos que mueven un proceso real del otro lado, comprueba que ese proceso funciona y agrega más cuando aparezca una necesidad concreta. Un flujo corto y confiable vale más que un chorro de datos que nadie lee.
Comprobar que el envío es nuestro
Cada webhook tiene un secreto de firma. Lo ves al editar el webhook, con un botón para copiarlo. Cada envío lleva el encabezado X-HellouOne-Signature con una firma sha256, que es el HMAC-SHA256 del cuerpo de la petición usando ese secreto. Tu sistema debería recalcular la firma sobre el cuerpo tal como llegó, sin volver a convertirlo a JSON, y descartar lo que no coincida. Ese detalle, usar el cuerpo crudo tal como llegó, es el paso que los equipos más suelen hacer mal, y es la diferencia entre una verificación que funciona y una que rechaza envíos legítimos. El nombre del encabezado se conserva por compatibilidad con integraciones existentes, así que los sistemas que ya lo escuchan siguen funcionando. Trata el secreto como una contraseña. Guárdalo en el almacén de secretos de tu sistema, no en el código ni en un documento compartido, y limita quién puede verlo en HellouOne a las personas que administran las integraciones.
Rotar el secreto cuando hace falta
Si el secreto se filtra, edita el webhook y pulsa Rotar secreto y luego Rotar. El secreto anterior deja de funcionar al instante, también para los envíos que estaban en cola, así que actualiza tu sistema enseguida. Planea la rotación como un solo movimiento: cambia el secreto en HellouOne y despliega el valor nuevo en tu sistema en la misma ventana, después observa los envíos siguientes para confirmar que la verificación vuelve a pasar. Rotar también es buena higiene después de cambiar de proveedor o de equipo del lado receptor. Un webhook que apunta en silencio a un sistema que ya nadie administra es una fuga de datos en cámara lenta. Revisa tu lista de webhooks como parte de las salidas de personal y las revisiones de proveedores, y borra lo que ya no sirva a un proceso que puedas nombrar.
Para profundizar
La lista completa de eventos, el formato de cada uno y la API para gestionar webhooks están en la referencia de la API, en la sección de eventos de webhook. Empieza por una integración que elimine un trabajo manual que tu equipo siente cada día, verifica las firmas como corresponde y crece desde un flujo en el que confías. Así una plataforma de conversaciones se vuelve parte de tus sistemas, en lugar de otra isla al lado de ellos.
Fuente: Centro de ayuda de Hellou, Integraciones y webhooks: https://help.hellou.ai/hc/hellou/articles/1791216503-integraciones-y-webhooks
