# Notificaciones y alertas

> Elige a quién se avisa cuando un agente cualifica un lead, pone una etiqueta o pierde su número: por correo, WhatsApp o webhook, agente por agente.

Source: https://docs.whatsetter.com/es/dashboard/notifications/

WhatSetter avisa a tu equipo de tres cosas: un lead que tu agente ha
cualificado, una etiqueta que tu agente ha puesto en un lead, y un agente cuyo
número de WhatsApp se ha desconectado. Las tres se configuran agente por
agente: cada agente puede avisar a personas distintas.

## Dónde se configuran ahora las notificaciones

Abre **Agentes**, haz clic en tu agente, abre la pestaña **Ajustes** y luego
**Traspaso y alertas**. La sección contiene dos bloques:

| Bloque | Qué envía |
|---|---|
| **Cuando un lead está calificado** | Un correo, un mensaje de WhatsApp o un webhook cuando el agente cualifica un lead, lo descarta, o pone una etiqueta que elegiste. |
| **Si su número se desconecta** | Un correo cuando el número de WhatsApp del agente deja de responder. |

En el panel antiguo, estos ajustes estaban en el panel de la campaña, en
Notificaciones, y en la página de WhatsApp. Las campañas ahora se llaman
agentes: los ajustes siguen a cada agente.

Un agente de grupo no tiene sección **Traspaso y alertas**. No se envía
ninguna notificación cuando se reserva una cita: tu herramienta de calendario
envía las suyas.

## Elegir qué leads disparan una notificación

Abre **Agentes**, haz clic en tu agente, abre la pestaña **Ajustes** y luego
**Traspaso y alertas**. Bajo **Avísame cuando un lead sea:**, elige uno de los
cuatro casos:

| Opción | Sale una notificación cuando |
|---|---|
| **Cualificado** | Tu agente cualifica el lead en la conversación. Es la opción por defecto. |
| **No interesado** | Tu agente descarta el lead. |
| **Ambos** | Cualquiera de los dos. |
| **Ninguno** | Nunca por la cualificación: solo por las etiquetas elegidas, más abajo. |

La opción se aplica al correo y al webhook. El mensaje de WhatsApp solo
existe para los leads cualificados: con **No interesado** seleccionado, no
sale ningún mensaje de WhatsApp.

Un lead dispara cada notificación una sola vez. Si el mismo lead se cualifica
una segunda vez más tarde, no se te vuelve a avisar.

Cada cambio se guarda solo: **Guardado** aparece en la parte superior del
bloque.

## Recibir un correo cuando un lead está cualificado

1. Abre **Agentes**, haz clic en tu agente, abre la pestaña **Ajustes** y luego **Traspaso y alertas**.
2. Activa **Por correo**.
3. Escribe una dirección y pulsa Enter o la coma. Puedes añadir hasta 5 direcciones.
4. En **Idioma de las notificaciones**, elige Français, English, Español o Deutsch.

Cada dirección recibe un correo por lead. Indica el nombre y el número del
lead, el nombre del agente, cómo clasificó la IA al lead y por qué, y un
botón que abre la conversación.

El idioma es el de tu panel el día en que activas el primer canal, mientras
no elijas otro. Vale solo para este agente: para el correo, el resumen de
WhatsApp y los mensajes de etiqueta.

## Recibir por WhatsApp un resumen de cada lead cualificado

1. Abre **Agentes**, haz clic en tu agente, abre la pestaña **Ajustes** y luego **Traspaso y alertas**.
2. Activa **Por WhatsApp**.
3. Escribe el número que debe recibir los resúmenes, en formato internacional: de 8 a 15 dígitos, por ejemplo 34612345678. El campo solo conserva los dígitos.

Por cada lead cualificado, ese número recibe un mensaje de WhatsApp escrito
por la IA a partir de la conversación: el nombre y el número del lead, su
interés principal, un resumen en dos o tres frases, hasta cuatro respuestas
clave y un próximo paso sugerido.

- El mensaje sale del número del propio agente: ese número debe estar conectado.
- Se escribe en el **Idioma de las notificaciones** del agente, o en francés si no se eligió ninguno.
- Se envía una vez por lead, y solo para los leads cualificados.

## Enviar los leads cualificados a tus herramientas por webhook

1. Abre **Agentes**, haz clic en tu agente, abre la pestaña **Ajustes** y luego **Traspaso y alertas**.
2. Activa **Por webhook (avanzado)**.
3. Pega una URL que empiece por `http://` o `https://` y pulsa Enter. Puedes añadir hasta 3 URL.
4. Para firmar las llamadas, abre **Avanzado (firma HMAC)** y escribe un **Secreto de firma**, o haz clic en **Generar**.

Cada lead que coincide con tu opción dispara una petición POST a cada URL. El
cuerpo JSON contiene `event_type` (`contact.qualified` o
`contact.not_qualified`), `event_id`, `occurred_at`, el agente en `campaign`,
y el lead en `contact`: nombre, número, clasificación, el razonamiento de la
IA y un enlace a la conversación.

Con un secreto, cada llamada lleva una cabecera `X-Whatsetter-Signature`:
`sha256=` seguido del HMAC SHA-256 del cuerpo. Una llamada se intenta una
sola vez: si tu dirección no responde, esa notificación se pierde.

Para recibir los eventos de todo el espacio desde tu propio código, consulta
[Webhooks](/es/developers/webhooks/).

## Recibir un aviso cuando el agente pone una etiqueta

Cuando las etiquetas del agente están activadas, puedes recibir un aviso cada
vez que el agente pone una en un lead. Mira
[Etiquetas del agente](/es/dashboard/labels/).

1. Abre **Agentes**, haz clic en tu agente, abre la pestaña **Ajustes** y luego **Traspaso y alertas**.
2. En **Y cuando el agente pone la etiqueta**, haz clic en cada etiqueta de la que quieres un aviso. Una marca señala las elegidas.
3. Activa al menos un canal y dale un destinatario: **Por correo**, **Por WhatsApp** o **Por webhook (avanzado)**.

Cada etiqueta que pone el agente sale por todos los canales activados:

- el correo tiene como asunto «Etiqueta» seguido del nombre de la etiqueta, con el lead, por qué la puso el agente y un botón que abre la conversación;
- el mensaje de WhatsApp sale del número del propio agente;
- cada URL de webhook recibe `contact.label_added`, firmado como los demás eventos. Mira [Webhooks firmados](/es/developers/webhooks/#contactlabel_added).

Un mensaje solo sale para un lead activo en las últimas 24 horas: cuando
activas las etiquetas, las conversaciones más antiguas que el agente relee una
vez no envían nada. Mientras las etiquetas del agente están desactivadas, no
sale nada. Una etiqueta que pone una persona tampoco envía nada.

## Enviar una notificación de prueba

Abre **Agentes**, haz clic en tu agente, abre la pestaña **Ajustes** y luego
**Traspaso y alertas**, y haz clic en **Enviar prueba**. El botón funciona en
cuanto un canal está activado y tiene un destinatario.

La prueba envía una notificación de lead cualificado para un lead inventado,
Jean Dupont (test), +33612345678:

- el correo llega con un asunto que empieza por `[TEST]` y un aviso que dice que no se cualificó ningún lead real;
- cada URL de webhook recibe el cuerpo habitual, con `is_test` en `true`;
- el número de WhatsApp recibe una breve confirmación, enviada desde el número del agente.

Tres límites que conviene conocer:

- La prueba representa un lead cualificado. Con **No interesado** seleccionado, el correo y el webhook no reciben nada.
- La prueba no envía ningún mensaje de etiqueta.
- Si el número del agente no está conectado, la parte de WhatsApp no sale.

## ¿Hay una notificación cuando se reserva una cita?

No. Cuando tu agente reserva una cita en la conversación, WhatSetter no envía
ni correo, ni mensaje de WhatsApp, ni webhook. Se aplican las notificaciones
de tu herramienta de calendario (Calendly, Cal.com o GoHighLevel): ahí es
donde recibes la invitación.

En WhatSetter, la cita aparece en el lead. Abre **Leads** y la vista
**Citas programadas**, o abre la pestaña **Resumen** del agente y haz clic en
**Citas**. Consulta [Citas](/es/dashboard/bookings/).

Si quieres que se te avise de un lead en cuanto tu agente lo ha cualificado,
usa la notificación de lead cualificado: sale tanto si se reserva una cita
como si no.

## Recibir un correo cuando el número del agente se desconecta

Abre **Agentes**, haz clic en tu agente, abre la pestaña **Ajustes** y luego
**Traspaso y alertas**, y ve a **Si su número se desconecta**. Una línea
verde confirma que las alertas están activadas.

No hay nada que activar. Mientras no haya ninguna dirección guardada, la
alerta va al correo de la cuenta propietaria del espacio.

1. En **Destinatarios de email**, escribe una dirección y haz clic en **Añadir**. Repite para cada persona.
2. En **Idioma de las notificaciones**, elige Français, Español, English o Deutsch.
3. Haz clic en **Guardar alertas**.
4. Haz clic en **Envíame una alerta de prueba** para recibir un correo de ejemplo en las direcciones guardadas.

Si guardas sin ninguna dirección, tu propio correo queda guardado como
destinatario. La alerta es solo un correo: no se envía ningún mensaje de
WhatsApp por una desconexión.

## Cuándo sale una alerta de desconexión, y cuántas

Una alerta sale cuando se cumple todo esto:

- el agente está **Activo**. Un agente en pausa o un borrador no envía alertas;
- su número se conectó al menos una vez y lleva 30 minutos o más sin responder;
- no desconectaste el número tú mismo desde el panel;
- el número sigue fuera de servicio cuando se comprueba una última vez, justo antes de enviar el correo.

Recibes 3 correos como máximo por desconexión: a los 30 minutos, luego a las
24 horas y a las 48 horas. Después las alertas se detienen solas, hasta que
el número se vuelva a conectar y se caiga de nuevo.

Un correo lista todos los agentes desconectados de los que un destinatario es
responsable. Indica la hora de la desconexión y, cuando se conoce, la causa
probable.

En la app, el agente muestra **Desconectado** y el botón **Reconectar** en lo
alto de su página. Consulta [Números de WhatsApp](/es/dashboard/numbers/).

El enlace de reconexión del correo abre, una vez que has iniciado sesión, la
página **Números de WhatsApp** con la ventana que reconecta ese agente. Si el
agente está en otro espacio distinto del que tienes abierto, la ventana te
pide que elijas el agente.

## Quién puede cambiar las notificaciones

Cambiar los dos bloques de **Traspaso y alertas** requiere el permiso
**Modificar los agentes y sus prompts**. Por defecto lo tienen los perfiles
**Propietario**, **Admin** y **Editor**. Consulta
[Equipo](/es/dashboard/team/).

Cualquier miembro que pueda abrir el agente puede hacer clic en
**Enviar prueba** y en **Envíame una alerta de prueba**.

Las notificaciones de leads se guardan solas, campo por campo. Las alertas de
desconexión solo se guardan cuando haces clic en **Guardar alertas**: una
dirección escrita sin guardar no recibe alertas.

Los ajustes son propios de cada agente. Cuando creas o duplicas un agente,
abre su sección **Traspaso y alertas** y revisa los dos bloques.

## Por qué no llegó una notificación de lead cualificado

Abre **Agentes**, haz clic en tu agente, abre la pestaña **Ajustes** y luego
**Traspaso y alertas**, y revisa estos puntos:

- El canal está desactivado, o no tiene destinatario. Un correo necesita al menos una dirección, un webhook al menos una URL.
- **Avísame cuando un lead sea:** está en el otro caso.
- El lead ya fue notificado una vez: un lead dispara cada notificación una sola vez.
- Para WhatsApp: el número del agente estaba desconectado, o el lead no estaba cualificado.
- Para un webhook: tu dirección no respondió. La llamada no se vuelve a intentar.
- Al lead lo cualificó una persona, no el agente: la notificación sigue la decisión del agente en la conversación.

Haz clic en **Enviar prueba** para comprobar el canal en sí, y mira en tu
carpeta de correo no deseado.

## Relacionado

- [Agentes](/es/dashboard/agents/)
- [Citas](/es/dashboard/bookings/)
- [Números de WhatsApp](/es/dashboard/numbers/)
- [Webhooks](/es/developers/webhooks/)
