Configurar una conexión webhook
Con una conexión webhook, puedes reenviar automáticamente los datos de contacto que recopila tu Agente IA a un sistema externo, como tu CRM, herramienta de marketing o plataforma interna. Así no tienes que copiar nada manualmente y los leads llegan directamente al lugar correcto.
En este artículo te explicamos paso a paso cómo configurar una conexión webhook desde Heyloha.
¿Qué es un webhook?
Un webhook es una forma de enviar datos automáticamente de un sistema a otro. En cuanto tu Agente IA ha recopilado los datos de contacto necesarios, Heyloha envía esos datos mediante una solicitud HTTP POST a la URL que hayas configurado. El sistema receptor procesa los datos, por ejemplo creando un nuevo contacto en tu CRM.
¿Qué necesitas?
- Una cuenta activa de Heyloha con al menos un Agente IA.
- Un sistema externo que soporte webhooks (por ejemplo un CRM, plataforma de marketing o aplicación propia).
- La URL del webhook del sistema receptor, incluyendo los parámetros necesarios.
La función de webhook debe estar habilitada a nivel de empresa. Si no ves la opción 'Conexiones' en el menú de tu Agente IA, contacta a tu administrador.
Configurar una conexión webhook
Ve a tu Agente IA
Abre el panel de Heyloha y haz clic en el Agente IA para el que quieres configurar la conexión.
Abre el menú 'Conexiones'
En el menú lateral de tu Agente IA, encontrarás la opción 'Conexiones'. Haz clic para abrir el resumen.
Haz clic en 'Agregar integración'
Accederás a un formulario paso a paso para crear una nueva conexión webhook.
Pega la URL del webhook
Copia la URL completa del webhook del sistema receptor y pégala en el campo. La URL suele contener parámetros como 'company' y 'webhook'. Heyloha reconoce automáticamente la URL y sus parámetros.
Nombra la integración
Elige un nombre fácil de reconocer, por ejemplo 'Reenvío de lead CRM' o 'Solicitud de presupuesto'. Este nombre también se usa como nombre de función interna para tu Agente IA.
Selecciona los campos de contacto
Elige qué datos debe recopilar y reenviar tu Agente IA. Puedes elegir entre: nombre, apellido, correo electrónico, número de teléfono, dirección, código postal, ciudad y país.
Describe cuándo debe usarse la conexión
Proporciona una breve descripción de cuándo tu Agente IA debe activar esta conexión, por ejemplo: 'Usa esta conexión cuando un visitante muestre interés en una visita y deje sus datos de contacto.'
Guarda y activa
Configura la conexión como 'Activa' y haz clic en Guardar. No olvides guardar también el Agente IA para que los cambios surtan efecto.
Los cambios en las conexiones solo surten efecto después de guardar el Agente IA. ¡No olvides este paso!
¿Qué datos de contacto puedes reenviar?
Tú decides qué campos recopila y reenvía tu Agente IA mediante el webhook. Los campos disponibles son:
- Nombre
- Apellido
- Correo electrónico
- Número de teléfono
- Dirección
- Código postal
- Ciudad
- País
Selecciona al menos un campo. El Agente IA solicita estos datos de forma natural durante la conversación y los reenvía automáticamente una vez que se alcanza el objetivo.
¿Cómo funciona en la práctica?
Cuando un visitante chatea con tu Agente IA y proporciona los datos requeridos, Heyloha envía automáticamente una solicitud a la URL del webhook configurada. El sistema receptor procesa los datos de contacto, para que tu equipo pueda hacer seguimiento de inmediato.
- Un visitante del sitio web inicia una conversación con tu Agente IA.
- El Agente IA reconoce el objetivo (por ejemplo: reenviar lead) y solicita los datos necesarios.
- Después de recopilar los datos, Heyloha los envía al sistema externo mediante el webhook.
- El sistema receptor procesa los datos (por ejemplo: crear un nuevo contacto).
- Tu equipo recibe una notificación y puede hacer seguimiento del lead.
Gestionar conexiones
En el resumen de 'Conexiones', puedes ver todas tus conexiones webhook activas e inactivas. Aquí puedes:
- Editar una conexión (cambiar URL, nombre, campos o descripción).
- Activar o desactivar una conexión mediante el interruptor de estado.
- Eliminar una conexión si ya no la necesitas.
Puedes configurar múltiples conexiones webhook por Agente IA, cada una con su propio objetivo y conjunto de campos de contacto. Por ejemplo, puedes configurar una conexión para visitas y otra separada para solicitudes de presupuesto.
Preguntas frecuentes
Ejemplos de conexiones webhook
- Sistema CRM: Reenviar leads automáticamente a tu sistema de gestión de clientes.
- Herramienta de email marketing: Agregar nuevos contactos a una lista de correo.
- Plataforma interna: Reenviar solicitudes de visita o presupuesto al equipo correcto.
- Helpdesk: Crear tickets de soporte basados en conversaciones con tu Agente IA.
Preguntas frecuentes
¿Puedo probar el webhook?
Sí. Guarda la conexión y guarda tu Agente IA. Luego inicia una conversación de prueba con tu Agente IA y proporciona los datos requeridos. Verifica en el sistema receptor si los datos se recibieron correctamente.
¿Qué hacer si el webhook no funciona?
Verifica que la URL del webhook sea correcta, que la conexión esté configurada como 'Activa' y que hayas guardado el Agente IA después de crear la conexión. También verifica en el sistema receptor si el webhook está activo de su lado.
¿Qué sistemas son compatibles?
La conexión webhook funciona con cualquier sistema que pueda recibir una solicitud HTTP POST con datos de formulario. Esto incluye sistemas CRM, herramientas de marketing, aplicaciones internas y más.
¿Cuántas conexiones puedo configurar?
No hay límite. Puedes configurar múltiples conexiones por Agente IA, cada una con su propio objetivo y campos de contacto.
Configurar objetivos para tu Agente IAConfigurar un webhook con KeyVue