Webhook | Yampi.ai

Un webhook es la forma en que Yampi le avisa automáticamente y en tiempo real a otro sistema cuando algo pasa en tu cuenta: llegó un mensaje, se creó un contacto, cambió el estado de una conversación. Tú eliges qué eventos te interesan y Yampi envía una notificación (una llamada HTTP) a la dirección que definas, con los datos de cada evento.

Nota: esta es una integración pensada para usos avanzados. Para configurarla no necesitas programar, pero para aprovechar lo que envía sí se requiere apoyo técnico (un desarrollador o una herramienta de automatización como Zapier, Make o n8n).

¿Para qué sirve?

Piensa en el webhook como un mensajero: en lugar de que otro sistema esté preguntándole a Yampi cada rato "¿hay algo nuevo?", Yampi le avisa al instante cada vez que ocurre algo. Con eso puedes, por ejemplo:

Sincronizar contactos con tu propio CRM o base de datos: cada contacto que se crea o se edita en Yampi se replica automáticamente en tu sistema.
Recibir alertas en tiempo real en herramientas internas (por ejemplo, un aviso en Slack o un correo al equipo) cuando entra una conversación nueva.
Alimentar tus propios reportes o dashboards con la actividad de mensajes y conversaciones.
Conectar Yampi con automatizadores como Zapier, Make o n8n, que reciben el evento y disparan flujos sin necesidad de desarrollar un sistema propio.
Construir integraciones a la medida con los sistemas internos de tu inmobiliaria.

El webhook solo envía información hacia afuera; no modifica nada dentro de Yampi.

Antes de empezar

Necesitas una URL pública capaz de recibir las llamadas de Yampi (lo que técnicamente se llama un endpoint). Esa URL te la da:

tu equipo de desarrollo, si van a conectar un sistema propio,
la herramienta de automatización (Zapier, Make y n8n generan una URL de webhook al crear un flujo), o
un servicio de prueba como webhook.site, si solo quieres ver cómo funciona antes de conectarlo en serio.

Paso 1: abrir la configuración del Webhook

Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda.
En el menú de Ajustes, haz clic en Integraciones.
Ubica la tarjeta Webhook y haz clic en Configurar.

Paso 2: añadir un nuevo webhook

Se abre la pantalla Webhook. Aquí verás la lista de webhooks de tu cuenta; si aún no has creado ninguno, aparece el mensaje "No hay webhooks configurados para esta cuenta". Cuando tengas varios, puedes ubicarlos con la barra Buscar webhooks.

Haz clic en el botón Añadir nuevo webhook (arriba a la derecha).

Paso 3: completar el formulario

En el modal Añadir nuevo webhook completa:

URL de Webhook: la dirección a la que Yampi enviará los eventos (por ejemplo, https://tuempresa.com/api/webhook). Debe ser una URL válida y accesible desde internet.
Nombre del Webhook: un nombre descriptivo para reconocerlo en la lista (por ejemplo, "Sincronización CRM" o "Alertas Slack").
Eventos: marca las casillas de los eventos que quieres recibir (abajo te explicamos cada uno).
Haz clic en Crear webhook.

Desde ese momento, cada vez que ocurra uno de los eventos marcados, Yampi enviará la notificación a tu URL.

Los eventos disponibles

Evento	Nombre interno	Se dispara cuando...
Conversación creada	`conversation_created`	Se abre una conversación nueva en cualquier canal.
Estado de la conversación cambiado	`conversation_status_changed`	Una conversación cambia de estado (por ejemplo, se abre, se pospone o se resuelve).
Conversación actualizada	`conversation_updated`	Cambia alguna propiedad de la conversación, como el agente asignado, las etiquetas o sus atributos.
Mensaje creado	`message_created`	Se envía o se recibe un mensaje en cualquier conversación.
Mensaje actualizado	`message_updated`	Un mensaje existente cambia (por ejemplo, su estado de entrega).
Widget de Live Chat abierto por el usuario	`webwidget_triggered`	Un visitante abre el widget de chat en tu sitio web.
Contacto creado	`contact_created`	Se crea un contacto nuevo en la cuenta.
Contacto actualizado	`contact_updated`	Se editan los datos de un contacto existente.
Conversation Typing On	`conversation_typing_on`	Alguien comienza a escribir en una conversación.
Conversation Typing Off	`conversation_typing_off`	Alguien deja de escribir en una conversación.

Consejo: marca solo los eventos que de verdad vas a usar. Eventos como message_created o los de typing generan un volumen alto de llamadas; si tu sistema solo necesita los contactos nuevos, basta con contact_created.

Cómo funciona por dentro (para tu equipo técnico)

Por cada evento, Yampi hace una petición HTTP POST a la URL configurada, con un cuerpo en formato JSON que describe el evento y sus datos (la conversación, el mensaje o el contacto involucrado).
El sistema que recibe debe responder con un código de éxito (200).
Un mismo webhook puede suscribirse a varios eventos, y puedes crear varios webhooks apuntando a URLs distintas (por ejemplo, uno para el CRM y otro para las alertas internas).

Probar el webhook sin programar

¿Quieres ver los eventos en acción antes de conectar un sistema real?

Entra a webhook.site y copia la URL única que te genera.
En Yampi, crea un webhook con esa URL y marca un evento fácil de provocar, por ejemplo Contacto creado.
Crea un contacto de prueba en Yampi.
Vuelve a webhook.site: verás llegar la llamada con todos los datos del contacto en formato JSON.

Cuando termines la prueba, elimina ese webhook para no seguir enviando datos de tu cuenta a un servicio externo.

Administrar tus webhooks

Los webhooks creados aparecen en la lista de la pantalla Webhook, identificados por su nombre y su URL. Desde ahí puedes revisar cuáles están activos y gestionar cada uno.

Preguntas frecuentes

¿Necesito saber programar para usar webhooks? Para crearlos en Yampi no, el formulario es simple. Para recibir y aprovechar los datos sí se necesita apoyo técnico o una herramienta de automatización (Zapier, Make, n8n).

¿El webhook puede modificar información en Yampi? No. Los webhooks solo envían información hacia afuera. Para que otro sistema escriba datos en Yampi se usan otros mecanismos (como la API).

¿Puedo tener varios webhooks a la vez? Sí. Puedes crear uno por cada sistema de destino, cada uno con su propia URL y su propia selección de eventos.

¿Qué pasa si mi URL deja de funcionar? Yampi intentará entregar los eventos, pero si tu sistema no responde, esas notificaciones se pierden. Verifica que la URL esté siempre disponible.