# Agentes

> Encuentra todos tus agentes en una lista, lee su estado, activa, pausa, duplica o elimina un agente, y abre su página con sus seis pestañas.

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

Un agente es la IA que habla con tus contactos en WhatsApp. Las campañas ahora
se llaman agentes: lo que estaba repartido entre Campañas, Prompts y el
Playground está ahora en la página del propio agente.

## Qué es un agente

Abre **Agentes** en el menú. Cada línea de la página es un agente, y un agente
tiene todo lo que necesita para trabajar:

- lo que dice: sus instrucciones, su primer mensaje y sus seguimientos;
- lo que sabe: el conocimiento que lee antes de responder;
- el número de WhatsApp desde el que escribe;
- sus pruebas, su actividad y sus resultados.

Un agente responde en mensajes privados o en tus grupos de WhatsApp. Esta
página trata de los agentes que responden en mensajes privados. Los agentes de
grupo tienen su propia lista: cuando tienes alguno,
**Ver los agentes de grupo** la abre desde el final de la página. Mira
[Grupos de WhatsApp](/es/dashboard/groups/).

## Dónde están ahora Campañas, Prompts y el Playground

El menú ya no tiene página Campañas, Prompts ni Playground. Lo que hacían está
ahora en la página de cada agente, en **Agentes**.

| Antes | Ahora |
|---|---|
| Campañas | **Agentes**: cada campaña es ahora un agente. |
| Prompts | La pestaña **Prompt** de un agente. |
| Playground | La pestaña **Probar** de un agente. |

Los enlaces antiguos siguen funcionando: un marcador hacia Campañas, Prompts o
el Playground abre la lista **Agentes**, o el propio agente en la pestaña que
corresponde. En la ventana de búsqueda (Ctrl+K), escribir «campañas»,
«prompts» o «playground» también los encuentra.

## Crear un agente

1. Abre **Agentes**.
2. Haz clic en **Nuevo agente**. Si todavía no tienes ningún agente, el botón se llama **Crear un agente**.
3. Responde a las preguntas de la ventana de creación. Están descritas en [Crea tu agente IA](/es/getting-started/agent/).

Un agente nuevo empieza como borrador: no envía nada y no cuenta en tu plan.

Crear un agente requiere el permiso **Crear un agente**. Sin él, la ventana
**Permiso necesario** te dice que se lo pidas al propietario del equipo.

Puedes guardar agentes en preparación, pero no sin límite. El número total de
agentes, sea cual sea su estado, no puede superar los agentes activos de tu
plan más 5 en el plan gratuito, 30 en Starter, 60 en Business y 200 en Scale.
Más allá, **Nuevo agente** abre la ventana **Muchos agentes en preparación**,
que te pide que borres los que ya no sirven. Si además todos los agentes
activos de tu plan están ocupados, la ventana se titula
**Todos tus agentes ya están trabajando**.

## Los agentes de Instagram y Messenger

Tras **Nuevo agente**, la primera pregunta es **¿Dónde trabaja tu agente?**:
**WhatsApp**, **Instagram**, **Messenger**, uno o varios. Un agente responde o
bien en WhatsApp, o bien en Instagram y Messenger: con los dos marcados, las
mismas respuestas crean dos agentes, uno en cada pestaña de **Agentes**.
Con Instagram o Messenger, el resumen añade **Sus misiones**,
cada una con su interruptor: una automatización que responde a una palabra
clave en tus próximos posts (creada apagada, para que la revises primero),
**Responder a todos los mensajes privados**, y **Messenger** en cuanto tu
página de Facebook esté vinculada. En **Trabaja en**, elige una cuenta
conectada o **Una cuenta por conectar**: el agente muestra entonces
**Esperando su cuenta**, y la próxima cuenta de Instagram que conectes lo toma
con sus misiones.

Estos agentes están en **Agentes**, pestaña **Instagram**, uno por cuenta
conectada, sin número que vincular. Sus pestañas **Prompt**, **Probar** y
**Ajustes** funcionan como para un agente de WhatsApp, y **Ajustes** tiene una
sección **Instagram**. Para activar uno, dale un nombre, haz clic en
**Activar** y elige quién responde en la cuenta. El mismo agente responde en
Messenger en la página de Facebook vinculada a la cuenta. Consulta
[Instagram y Messenger](/es/dashboard/instagram/).

## Leer la lista de agentes

Abre **Agentes**. La línea de arriba cuenta tus agentes y cuántos están
activos frente a lo que permite tu plan, por ejemplo «5 agentes · 2 activos de
3». Debajo, los agentes se agrupan según lo que necesitan de ti:

| Sección | Qué agentes contiene |
|---|---|
| **Por revisar** | Agentes activos a los que algo les impide responder con normalidad: un número por conectar o reconectar, o un límite que pone WhatsApp. |
| **En servicio** | Agentes activos que trabajan. |
| **En pausa** | Agentes que pausaste. No responden ni envían nada hasta que los reanudes. |
| **Borradores** | Agentes que todavía no están activados. No cuentan en tu plan. |

**Borradores** queda plegada mientras existan otros agentes: haz clic en
**Ver los borradores** para abrirla. Los agentes se ordenan por nombre, los
borradores por cambio más reciente.

Con más de un agente aparece un campo de búsqueda. Encuentra un agente por su
nombre en tu lista, su nombre de pila o su número.

## Qué muestra una fila de la lista

Abre **Agentes**. Cada fila muestra, de izquierda a derecha:

- la foto del número de WhatsApp del agente, o sus iniciales mientras no haya un número vinculado;
- su nombre en tu lista, y su nombre de pila cuando los dos son distintos;
- una frase que dice qué hace el agente o qué lo detiene, por ejemplo «Responde en WhatsApp» seguida de su número;
- una pastilla de estado;
- como mucho un botón: lo siguiente que hay que hacer.

| Botón | Qué hace |
|---|---|
| **Conectar** | Abre el agente con la ventana que vincula un número de WhatsApp. |
| **Reconectar** | Abre la misma ventana, para un número que se cayó. |
| **Activar** | Activa un borrador. |
| **Reanudar** | Vuelve a poner en marcha un agente en pausa. |
| **Ver los límites** | Abre la pestaña **Actividad**, que muestra los límites que WhatsApp pone al número. |

Haz clic en cualquier otro punto de la fila para abrir el agente. Un agente
activo que trabaja no tiene botón: la pausa se hace desde la página del agente.

## Qué significa cada pastilla de estado

Cada fila de la lista **Agentes** lleva una pastilla.

| Pastilla | Significado |
|---|---|
| **Activo** | El agente está activado y su número está conectado: responde y envía. |
| **Conectando** | El agente está activado y su número se está conectando a WhatsApp. No hay nada que hacer. |
| **Desconectado** | El agente está activado pero su número se cayó. No sale nada hasta que lo reconectes. |
| **Por conectar** | El agente está activado pero no tiene número, o su número espera un nuevo escaneo del código QR. |
| **Envíos limitados** | WhatsApp bloquea los nuevos contactos en este número durante un tiempo. El agente sigue respondiendo a quien le escribe. |
| **Límite alcanzado** | El número usó todos los mensajes que WhatsApp le concede para el ciclo en curso. |
| **En pausa** | Pausaste el agente. |
| **Borrador** | El agente todavía no está activado. La frase junto a la pastilla dice qué falta. |

En la página del agente, la parte de arriba muestra dos pastillas en lugar de
una: el estado del número (**Conectado**, **Conectando**,
**Código QR por escanear**, **Desconectado** o **Sin número**) y el estado del
agente (**Activo**, **En pausa** o **Borrador**).

## Abrir un agente: su página y sus pestañas

Abre **Agentes** y haz clic en un agente. La parte de arriba de su página es
la misma en todas las pestañas: el nombre del agente, **Mensajes privados** o
**Grupos**, su número y sus dos pastillas. A la derecha: **Probar**, la acción
que importa ahora (**Conectar un número**, **Reconectar**, **Activar**,
**Reanudar** o **Pausar**) y **Más acciones**.

| Pestaña | Para qué sirve |
|---|---|
| **Resumen** | Lo que falta para que el agente trabaje, cómo van sus leads, sus últimas conversaciones. |
| **Prompt** | Lo que dice el agente: primer mensaje, conversación, seguimientos. Mira [El prompt de tu agente](/es/dashboard/prompt/). |
| **Ajustes** | Su nombre, su conocimiento, su estilo, su número, el envío, las citas, las alertas, las etiquetas y las integraciones. |
| **Probar** | Hacer de lead en una conversación simulada. Mira [Prueba tu agente](/es/dashboard/playground/). |
| **Actividad** | Las conversaciones por retomar, los envíos de hoy, los primeros contactos día a día, el estado de su número. |
| **Resultados** | Los nuevos contactos, los nuevos calificados y las primeras citas en un periodo. |

## Comprobar qué le falta a un agente para trabajar

Abre **Agentes**, haz clic en tu agente y quédate en **Resumen**. El primer
bloque dice **Listo: este agente está trabajando**, o cuenta lo que falta, por
ejemplo **Faltan 2 cosas para que funcione**. Enumera:

| Línea | Qué comprueba |
|---|---|
| **Un número de WhatsApp** | Hay un número conectado. Si no, el botón de la línea conecta o reconecta uno. |
| **Lo que sabe** | El agente tiene conocimiento con el que responder. Sin él, solo responde a partir de sus instrucciones. **Añadir** abre su conocimiento. |
| **Su enlace** | Se muestra solo cuando el agente debe enviar un enlace y no tiene ninguno. Mientras no lo añadas, el agente dice que alguien del equipo volverá a escribir a la persona. |
| **Activado** | El agente está activo. |

Debajo, **Sus leads** da cuatro cifras: **Leads** (desde el inicio),
**Aún sin contactar** (su primer mensaje nunca salió), **Calificados** (sin cita
por ahora) y **Citas** (en el calendario). Haz clic en una cifra para abrir
esos leads. **Últimas conversaciones** muestra las cinco últimas.

## Activar un agente

Un agente de WhatsApp necesita un número de WhatsApp conectado antes de poder
activarse. Un agente de Instagram o de Messenger no tiene número: necesita un
nombre, y luego **Activar** en su página pregunta quién responde en su cuenta
de Instagram.

1. Abre **Agentes** y haz clic en tu agente.
2. Si el botón de arriba se llama **Conectar un número**, haz clic en él y vincula el número en la ventana que se abre. Mira [Conecta tu WhatsApp](/es/getting-started/connect-whatsapp/).
3. Haz clic en **Activar**. La ventana que vincula el número también propone activar el agente una vez conectado el número.

Desde la lista, un borrador cuyo número está conectado muestra «Número
conectado. Puedes activar este agente.»: haz clic en **Activar** en su fila.

Una vez activo, el agente responde a quien le escribe, envía su primer mensaje
a los contactos de sus listas y hace seguimiento. Entonces cuenta en los
agentes activos de tu plan. Nada más conectar un número, la ventana lo dice:
los primeros mensajes a contactos nuevos salen 30 minutos después, las
respuestas salen enseguida.

Activar un agente, pausarlo o reanudarlo requiere el permiso
**Modificar los agentes y sus prompts**.

## Pausar y reanudar un agente

1. Abre **Agentes** y haz clic en el agente.
2. Haz clic en **Pausar** en la parte de arriba de su página. El agente pasa a la sección **En pausa** de la lista.
3. Para volver a ponerlo en marcha, haz clic en **Reanudar**, en su página o en su fila de la lista.

Un agente en pausa no responde ni envía nada hasta que lo reanudes. Su número
sigue conectado, así que no hay código QR que escanear de nuevo, y el lugar
que ocupaba en tu plan queda libre para otro agente.

Los mensajes que llegan durante la pausa se guardan: aparecen en
**Conversaciones**, para que puedas responder a mano. Cuando reanudas el
agente, responde a una persona la próxima vez que escribe, teniendo en cuenta
lo que dijo durante la pausa. Nunca escribe primero a quienes escribieron
durante la pausa, y no les envía ningún seguimiento mientras su último mensaje
siga sin respuesta.

**Pausar** es el botón de arriba solo mientras el agente trabaja con
normalidad. Cuando su número te necesita, el botón se llama **Reconectar** o
**Conectar un número** en su lugar.

Cuando una lista se reparte entre varios agentes, los contactos de un agente
en pausa pasan a los agentes que pueden escribir. Mira
[Listas e importación](/es/dashboard/lists/). También puedes pausar y reanudar
un agente [por la API](/es/developers/guides/campaigns/).

## Cuántos agentes pueden estar activos a la vez

Tu plan fija cuántos agentes pueden estar activos a la vez. Los agentes que
responden en mensajes privados y los agentes de grupo comparten el mismo
contador.

| Plan | Agentes activos |
|---|---|
| Starter | 1 |
| Business | 3 |
| Scale | 10 |

Los borradores y los agentes en pausa no cuentan. El contador se muestra
arriba de la lista **Agentes**, por ejemplo «2 activos de 3», y junto a
**Agentes** en el menú, con la forma 2/3.

El plan gratuito también muestra 1. En el plan gratuito construyes tu agente y
lo pruebas hasta donde lleguen tus créditos. Un plan de pago lo conecta a tu
número, y un agente necesita un número para activarse.

En Scale, escríbenos para añadir agentes a tu plan. Mira
[Plan y facturación](/es/dashboard/billing/).

## Por qué no puedes activar o reanudar un agente

Abre **Agentes** y lee la fila del agente: da el motivo.

- La fila dice que tu plan está completo, por ejemplo «Tu plan está completo: pausa un agente para reanudar este.» Todos los agentes activos de tu plan están ocupados, y el botón **Activar** o **Reanudar** de la fila aparece atenuado. Pausa otro agente, o cambia de plan desde **Suscripción**.
- El botón se llama **Conectar**: el agente todavía no tiene número de WhatsApp. Conecta uno primero.
- El botón se llama **Reconectar**: su número se cayó. Reconéctalo primero.
- El clic se rechaza: tu rol no tiene el permiso **Modificar los agentes y sus prompts**. Pídeselo a un administrador de tu equipo.

Si haces clic en **Activar** en la página del agente con el plan completo, la
activación se rechaza y un mensaje dice que se alcanzó el límite de agentes
activos.

## Por qué un agente no responde

Abre **Agentes** y lee la pastilla en la fila del agente. Cada estado tiene su
motivo y su solución.

| Pastilla | Por qué el agente se queda en silencio | Qué hacer |
|---|---|---|
| **Borrador** | Todavía no está activado. | Conecta un número si no tiene y haz clic en **Activar**. |
| **En pausa** | Lo pausaste. | Haz clic en **Reanudar**. |
| **Desconectado** | Su número se cayó. | Haz clic en **Reconectar**. |
| **Por conectar** | No tiene número, o su número espera un nuevo escaneo. | Haz clic en el botón de su fila. |
| **Activo** | Con un solo lead: el agente terminó la conversación, porque te lo pasó o lo consideró no calificado. Con todos: los mensajes de tu plan se agotaron este mes. | Abre el lead en [Conversaciones](/es/dashboard/conversations/), o mira [Plan y facturación](/es/dashboard/billing/). |

**Envíos limitados** no detiene las respuestas: solo se bloquean los primeros
mensajes a contactos nuevos.

## Por qué un agente muestra Desconectado

**Desconectado** significa que hay un número de WhatsApp vinculado al agente
pero que su conexión con WhatsApp se cayó. Hasta que lo reconectes, el agente
no responde ni envía nada.

El agente sigue **Activo**: pasa a la sección **Por revisar** de la lista y
vuelve a trabajar en cuanto el número regresa. No hay nada que activar de
nuevo.

1. Abre **Agentes**. El agente está en **Por revisar**, con la frase «Su número de WhatsApp está desconectado.»
2. Haz clic en **Reconectar** en su fila, o en la parte de arriba de su página.
3. Sigue la ventana que se abre. Mira [Números de WhatsApp](/es/dashboard/numbers/).

Reconectar requiere el permiso **Reconectar un número (código QR)**. Para que
te avisen por correo cuando un número se cae, abre los **Ajustes** del agente
y luego **Traspaso y alertas**.

## Qué significan Sin número, Por conectar y Código QR por escanear

Estos estados describen el número de WhatsApp del agente. Se muestran en la
parte de arriba de la página del agente y en la lista **Agentes**.

| Lo que lees | Significado | Qué hacer |
|---|---|---|
| **Sin número** | Ningún número está vinculado al agente: nunca se conectó ninguno, la ventana de conexión se cerró antes del escaneo, o su número se dio a otro agente. | Haz clic en **Conectar un número**. |
| **Código QR por escanear** | WhatsApp cerró la sesión del número. | Haz clic en **Reconectar** y escanea el nuevo código. |
| **Conectando** | El número se está conectando. | Espera. |
| **Por conectar** | En la lista, un agente activo en uno de los dos primeros casos. | Haz clic en el botón de su fila. |

Un borrador sin número no es una avería: su fila dice «Añade un número de
WhatsApp para empezar.» Un número sirve a un solo agente de mensajes privados.
Vincular un número que usa otro agente se lo quita a ese agente. Los pasos
están en [Números de WhatsApp](/es/dashboard/numbers/).

## Qué significan Envíos limitados y Límite alcanzado

Estas dos pastillas vienen de WhatsApp, no de tu plan. El agente sigue activo
y pasa a la sección **Por revisar**.

- **Envíos limitados**: WhatsApp bloquea los primeros mensajes a contactos nuevos en este número, a menudo hasta una fecha que se muestra en la fila. El agente sigue respondiendo a quien le escribe.
- **Límite alcanzado**: el número usó todos los mensajes que WhatsApp le da para el ciclo en curso. La fila dice cuántos se usaron sobre el total.

Haz clic en **Ver los límites** en la fila para abrir la pestaña
**Actividad**. Su bloque **Número de WhatsApp** muestra
**Mensajes en este ciclo**, cuándo empieza el próximo ciclo y cuándo se
verificó el estado por última vez. Se actualiza cada 15 minutos.

Cómo mantener un número en buen estado se explica en
[Cómo protegemos tu número](/es/dashboard/anti-ban/).

## Cambiar el nombre y los ajustes de un agente

Abre **Agentes**, haz clic en el agente y luego en la pestaña **Ajustes**. Su
menú tiene una entrada por tema:

| Entrada | Qué ajustas ahí |
|---|---|
| **Nombre** | **Nombre del agente**, para tus leads, y **Nombre en tu lista**, para tu equipo, y luego **Guardar**. |
| **Conocimiento** | Lo que lee antes de responder. Mira [Bases de conocimiento](/es/dashboard/knowledge-base/). |
| **Estilo** | Su forma de escribir. Mira [Mis Estilos](/es/dashboard/styles/). |
| **Número** | Su número de WhatsApp: **Conectar un número**, **Reconectar** o **Cambiar de número**. |
| **Envío** | **Dividir las respuestas largas** (y, cuando está activado, **Mensajes por respuesta**: hasta 3 o hasta 2), **Retraso del primer mensaje**, **Zona horaria de los seguimientos** y **Seguimientos los domingos**. Cada cambio se aplica de inmediato. |
| **Citas** | Su calendario y su **Enlace de citas**. Mira [Citas](/es/dashboard/bookings/). |
| **Traspaso y alertas** | Quién recibe el aviso de un lead cualificado, de una etiqueta elegida que pone el agente o de un número desconectado. Mira [Notificaciones y alertas](/es/dashboard/notifications/). |
| **Etiquetas** | Las etiquetas que el agente pone en sus leads, además de su etapa. Mira [Etiquetas del agente](/es/dashboard/labels/). |
| **Integraciones** | Los enlaces y formularios que le traen leads, y las herramientas a las que envía sus leads. |

Un agente de grupo solo tiene **Nombre**, **Conocimiento** y **Número**. La
pestaña requiere el permiso **Modificar los agentes y sus prompts**.

## Seguir lo que hace un agente

Abre **Agentes**, haz clic en el agente y luego en la pestaña **Actividad**.

- **Por retomar**: cuántos de sus leads aún no han sido contactados (su primer mensaje nunca salió), y cuántos están por atender: un prospecto escribió y nadie respondió, o una acción está atrasada. Haz clic en una cifra para abrir esos leads.
- **Envíos de hoy**: una línea por cada lista que envía el agente, con la cifra de hoy frente a la cuota del día, los días y las horas de envío, y el total enviado. Mira [Listas e importación](/es/dashboard/lists/).
- **Primeros contactos**: los leads cuyo primer contacto fue cada día, en 14, 30 o 90 días.
- **Conversaciones recientes**: las cinco últimas.
- **Número de WhatsApp**: el número, su estado y los límites que WhatsApp indica sobre él.

Si el número está desconectado, un aviso arriba lo dice y propone
**Reconectar el número**.

## Leer los resultados de un agente

Abre **Agentes**, haz clic en el agente, luego en la pestaña **Resultados**, y
elige un periodo. La pestaña muestra las tres cifras de la página
**Vista general**, solo para este agente:

- **Nuevos contactos**: leads cuyo primer contacto ocurrió en el periodo, escribiera quien escribiera primero.
- **Nuevos calificados**: leads que la IA calificó durante el periodo, aunque se contactaran antes.
- **Primeras citas**: cada lead cuenta una vez, el día en que se reservó su primera cita. Solo cuentan las citas reservadas con un calendario conectado.

Debajo, un bloque muestra en qué quedaron los nuevos contactos del periodo.
Cuando hay un test A/B en curso en el agente, una línea remite a él con
**Ver el test**. Con varios agentes, **Comparar con tus otros agentes** abre
[Analíticas](/es/dashboard/analytics/).

## Duplicar un agente

1. Abre **Agentes** y haz clic en el agente que quieres copiar.
2. Haz clic en **Más acciones**, el botón de tres puntos arriba a la derecha.
3. Haz clic en **Duplicar el agente**. Se abre la copia.

La copia es un borrador sin número de WhatsApp, y sus contadores empiezan de
cero. Conserva los textos del agente y lo que está guardado en el propio
agente: sus nombres, su idioma, su conocimiento y sus seguimientos. Su nombre
termina en «(copie)»: cámbialo en **Ajustes**.

La copia no se lleva el número, el calendario que reserva las citas, el aviso
que se envía cuando un lead está calificado ni el historial de versiones de
los textos. Ajusta de nuevo el calendario y el aviso en la copia.

Duplicar requiere el permiso **Crear un agente**. Se rechaza cuando ya guardas
el número máximo de agentes.

## Eliminar un agente

1. Abre **Agentes** y haz clic en el agente.
2. Haz clic en **Más acciones** y luego en **Eliminar el agente**.
3. Confirma en la ventana que pregunta, por ejemplo, **¿Eliminar a Julia?**

Eliminar un agente también desconecta su sesión de WhatsApp. Sus
conversaciones quedan en tus leads. El agente en sí no se puede recuperar.

> **Páusalo si solo quieres que se detenga**
Un agente en pausa no envía nada y conserva sus textos, su número y su
historial.

Eliminar requiere el permiso **Eliminar un agente**, que los roles
**Propietario** y **Admin** tienen por defecto.

## Quién puede hacer qué con los agentes

Cada acción comprueba un permiso del miembro, en el servidor.

| Permiso | Qué permite |
|---|---|
| **Ver los agentes** | Abrir la lista y la página de un agente, y probar el agente. |
| **Crear un agente** | **Nuevo agente** y **Duplicar el agente**. |
| **Modificar los agentes y sus prompts** | Las pestañas **Prompt** y **Ajustes**, **Activar**, **Pausar** y **Reanudar**. |
| **Eliminar un agente** | **Eliminar el agente**. |
| **Reconectar un número (código QR)** | **Conectar un número** y **Reconectar**. |

Las cifras de la pestaña **Resultados** también requieren **Ver las analíticas**.

Por defecto, **Propietario** y **Admin** los tienen todos. **Editor** los
tiene todos menos **Eliminar un agente**. **Lector** tiene **Ver los agentes**
y **Ver las analíticas**. **Respondedor** no tiene ninguno. Mira
[Equipo y roles](/es/dashboard/team/).

## Los agentes en la API pública

En la API pública, un agente se sigue llamando campaña. El `campaign_id` de un
lead o de una conversación es el identificador de su agente.

- `GET /campaigns` lista tus agentes, con su estado y si su número está conectado.
- `POST /campaigns/{id}/pause` y `POST /campaigns/{id}/resume` pausan y reanudan un agente. Reanudar comprueba los agentes activos de tu plan, como hace el panel.
- `POST /campaigns/{id}/leads` entrega un contacto a un agente, que le escribe primero.

Mira [API: campañas](/es/developers/guides/campaigns/).

## Relacionado

- [Crea tu agente IA](/es/getting-started/agent/)
- [El prompt de tu agente](/es/dashboard/prompt/)
- [Prueba tu agente](/es/dashboard/playground/)
- [Números de WhatsApp](/es/dashboard/numbers/)
