[Extensión] Cómo crear webhooks en Blip para enviar datos del bot a sistemas externos

1. Introducción

2. Funcionalidades

3. Instalación

4. Cómo crear y configurar un webhook

5. Ejemplos de uso

6. Consejos

7. Soporte

Descripción breve: Crea webhooks personalizados en Blip para enviar contactos, mensajes y eventos de tu chatbot automáticamente a CRM, hojas de cálculo y otros sistemas externos vía HTTP.

Introducción

La extensión Webhook Manager crea webhooks personalizados en Blip para enviar datos de tu bot automáticamente a sistemas externos. Cada vez que un contacto se actualiza, un mensaje transita en la conversación o se registra un evento, la extensión dispara una solicitud HTTP a la URL que definas, con el contenido en el formato que el sistema de destino espera.

Por ejemplo, puedes enviar cada nuevo contacto de WhatsApp a tu CRM tan pronto como aparece en la conversación, y la base externa se mantiene sincronizada sin trabajo manual. La URL y el cuerpo de la solicitud aceptan Liquid, así que puedes armar el payload con los campos del contacto, del mensaje o del evento.

Funcionalidades

• Creación de varios webhooks, cada uno con su propia configuración.

• Tres tipos de envío: contactos, mensajes y eventos (event tracking) de la conversación.

• Métodos HTTP POST, PUT y PATCH.

• Encabezados personalizados para autenticación, como token o API key.

• URL y cuerpo dinámicos con Liquid, usando campos del contacto, del mensaje o del evento.

• Opción de no enviar la solicitud cuando el cuerpo renderizado queda vacío.

• Edición y eliminación de los webhooks ya registrados.

Compatible con los siguientes canales: todos los canales disponibles en la plataforma Blip.

Nota: el Webhook Manager envía los datos en una sola vía. La respuesta de la API externa no regresa al flujo del bot.

Instalación

Atención: esta es una extensión paga, desarrollada por Wiv.

1. Accede a la Webhook Manager en Blip Store y activa la extensión.

2. Instala la extensión en el Enrutador o en el bot que procesa los canales usados en tu operación. La extensión empezará a recibir los contactos, mensajes y eventos de ese bot.

3. Abre el bot donde instalaste la extensión, haz clic en los tres puntos en la esquina superior derecha y selecciona Webhook Manager. Se abrirá la pantalla de gestión de los webhooks registrados.

En esta pantalla puedes crear nuevos webhooks, editar configuraciones existentes o eliminar los que ya no uses.

Cómo crear y configurar un webhook

Haz clic en Crear nuevo webhook. Se abrirá la pantalla de configuración con un webhook predeterminado, listo para que lo ajustes.

Configura los siguientes campos:

Tipos de envío

Selecciona qué información enviará el webhook. Puedes marcar uno o más tipos:

• Contacto: datos del contacto, como identity, nombre, correo electrónico, teléfono y campos extras.

• Mensaje: datos del mensaje, como id, tipo, remitente, destinatario, contenido y metadatos.

• Eventos: datos de event tracking, como identity, categoría, acción y campos extras.

URL

En el campo URL, indica el endpoint que recibe los datos, proporcionado por el sistema externo. El campo acepta Liquid, así que puedes armar URLs dinámicas basadas en campos del contacto o de la conversación. Por ejemplo:

Método

En Método, selecciona el método HTTP de la solicitud: POST, PUT o PATCH. Sigue la documentación del sistema de destino. En general, usa POST para crear un registro, PUT para reemplazar un registro completo y PATCH para actualizar parte de un registro.

Encabezado

Usa el encabezado para enviar datos de autenticación o identificación, como un token o una API key. Haz clic en Agregar nueva clave en el encabezado y llena la clave y el valor. Las claves del encabezado solo aceptan letras, guion y guion bajo. Un ejemplo común:

Cuerpo de la solicitud

En el campo Cuerpo, define el contenido enviado a la URL. El cuerpo acepta Liquid, lo que permite insertar variables, campos del contacto y lógica condicional. Están disponibles tres objetos, según el tipo de envío: contact, message y tracking. Por ejemplo, para enviar datos de un contacto:

Marca la opción Si el cuerpo está vacío, no realizar la solicitud cuando el cuerpo dependa de alguna condición. Si la lógica resulta en un cuerpo vacío, la extensión no envía la solicitud y evita llamadas innecesarias al sistema externo.

Después de llenar los campos, haz clic en Guardar webhook.

El webhook guardado aparece en la lista de webhooks registrados, donde puedes editarlo o eliminarlo cuando necesites. A partir de ahí, ya envía la información de Blip al sistema externo definido.

Ejemplos de uso

Un uso común del Webhook Manager es integrar el bot a un CRM o a una base externa de contactos, como HubSpot, RD Station, Salesforce, Airtable o una hoja de cálculo.

Para registrar nuevos contactos, crea un webhook del tipo Contacto, indica la URL de la API de destino, elige el método POST y arma el cuerpo con los campos necesarios: así, cada vez que se identifique un contacto, los datos se envían automáticamente al sistema externo.

Para actualizar contactos existentes, usa el método PUT o PATCH, según la API de destino, y envía los campos que cambian. Este tipo de configuración mantiene el sistema externo actualizado con la información más reciente del contacto en Blip.

Consejos

• Prueba la URL de destino con una herramienta como webhook.site antes de usar en producción, para verificar el formato que llega al sistema externo.

• Configura primero en un bot de homologación y, después de validar el comportamiento, replica en el bot de producción.

• Verifica que los campos usados en Liquid existan en el contacto o en el contexto de la conversación. Variables inexistentes generan envíos incompletos.

• Confirma con la documentación de la API de destino qué método usar y qué encabezados de autenticación enviar.

Soporte

En caso de dudas en la configuración o problemas con la extensión, contacta al equipo de soporte de Wiv al correo support@wiv.com.br.

¿Necesitas más ayuda? Explora nuestros contenidos en la Blip Academy o Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃