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

1. Haz clic en el ícono de **engranaje** (Ajustes) en la parte inferior de la barra lateral izquierda.

2. En el menú de **Ajustes**, haz clic en **Integraciones**.

3. Ubica la tarjeta **Webhook** y haz clic en **Configurar**.

   

![](https://app.yampi.ai/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeE9aQVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6e578ceb0e8b2030ad0586f32189f21e8d89c442/image.png?cw_image_width=918px)

## 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).

![](https://app.yampi.ai/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeFNaQVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--079fab52554eb9e621606d1d2032c77a4b341724/image.png?cw_image_width=742px)

## Paso 3: completar el formulario

![](https://app.yampi.ai/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeFdaQVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--fc50797c8af53dbb3c97ed4dbef2c1f884781a40/image.png?cw_image_width=438px)

En el modal **Añadir nuevo webhook** completa:

1. **URL de Webhook**: la dirección a la que Yampi enviará los eventos (por ejemplo, [`https://tuempresa.com/api/webhook`](https://tuempresa.com/api/webhook)). Debe ser una URL válida y accesible desde internet.

2. **Nombre del Webhook**: un nombre descriptivo para reconocerlo en la lista (por ejemplo, "Sincronización CRM" o "Alertas Slack").

3. **Eventos**: marca las casillas de los eventos que quieres recibir (abajo te explicamos cada uno).

4. 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?

1. Entra a **webhook.site** y copia la URL única que te genera.

2. En Yampi, crea un webhook con esa URL y marca un evento fácil de provocar, por ejemplo **Contacto creado**.

3. Crea un contacto de prueba en Yampi.

4. 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.