Manual de Atención
Cómo conectar una línea de WhatsApp, definir qué puede responder la IA, intervenir sin que el agente conteste encima, atender llamadas y enviar avisos masivos. Escrito para quien administra la atención del ISP, con los mismos nombres que aparecen en pantalla.
1Qué organiza el módulo
En el menú lateral el módulo se llama Atención. Dentro encontrarás cuatro pestañas:
| Pestaña | Para qué sirve |
|---|---|
| Panel | Resume mensajes, llamadas, créditos consumidos y conversaciones activas. |
| Canales | Administra las líneas de WhatsApp y el agente de IA que responde en cada una. |
| Registro | Agrupa tres subpestañas: Chats (conversaciones, pausa de la IA y detalle técnico de cada respuesta), Llamadas (resumen por contacto y pausa de la atención de voz) y Reportes (los casos que la IA elevó a una persona). |
| Automatizaciones | Envía Difusiones a una lista de números. |
El canal es la línea y su configuración. El chat es la conversación con un contacto. Cambiar el canal afecta futuras respuestas; pausar un chat afecta solamente a ese contacto.
2Puesta en marcha
La tarjeta Guía de configuración marca cada paso automáticamente. Si un paso que estaba Listo vuelve a pendiente, ahí se interrumpió la configuración.
Crea un canal. Ve a Canales → Nuevo Canal. Escribe un nombre y un rol fácil de reconocer, como “Soporte Principal” y “Asistente de soporte”.
Conecta WhatsApp. Escanea el QR desde el teléfono de la empresa: WhatsApp → Dispositivos vinculados → Vincular dispositivo. No uses el número personal de un colaborador.
Asigna un modelo de IA. El modelo determina qué tan bien comprende al cliente y cuántos créditos consume. Confirma también si admite imágenes o audio.
Escribe las instrucciones. Define identidad, alcance, horarios, reglas, datos permitidos y cuándo debe derivar a una persona.
Escribe desde otro teléfono y prueba preguntas normales, información incompleta, una nota de voz, una imagen y una solicitud de hablar con una persona. No anuncies el canal hasta revisar esas respuestas.
3Panel
El Panel es una vista de actividad, no una bandeja de entrada. Usa Actualizar para volver a consultar los datos.
| Indicador | Qué cuenta |
|---|---|
| Mensajes totales | Mensajes procesados por los canales de Atención. |
| Llamadas totales | Llamadas registradas en el módulo. |
| Créditos totales | Créditos consumidos por respuestas de chat, transcripción de notas de voz y llamadas con IA. Otros módulos se cobran por separado. |
| Conversaciones activas | Conversaciones que todavía están habilitadas para respuesta automática. |
Los gráficos Mensajes enviados por fecha, Llamadas por fecha y Créditos consumidos sirven para comparar actividad y costo a lo largo del tiempo.
4Crear un canal
Abre Canales → Nuevo Canal. Un canal debe tener, como mínimo, nombre, rol, modelo e instrucciones antes de atender clientes.
4.1Campos básicos
| Campo | Cómo llenarlo |
|---|---|
| Nombre del canal | Nombre interno que identifica la línea, por ejemplo “Soporte Principal”. El cliente no necesita verlo. |
| Rol del agente | Etiqueta corta, por ejemplo “Asistente de soporte”. No controla el comportamiento: las reglas reales van en Prompt del sistema. |
| Tipo de canal | Selecciona el método de conexión. La opción habitual es WhatsApp (QR). |
| Modelo IA | Motor que entiende y responde. La lista muestra costo por millón de tokens, ventana de contexto y capacidades multimedia. |
| Modelo de transcripción de audio | Convierte notas de voz en texto cuando el modelo principal no entiende audio por sí mismo. |
| Prompt del sistema | Instrucciones permanentes que el agente lee en cada conversación. |
4.2Tipo y modo de conexión
| Opción | Uso recomendado | Consideración |
|---|---|---|
| WhatsApp (QR) | Atención por chat con una cuenta enlazada mediante QR. | No requiere credenciales de Meta. Es la opción normal para comenzar. |
| Cloud API (voz) | Integración oficial de Meta con un número de WhatsApp Business verificado. | Requiere Phone Number ID, WABA ID, tokens, App Secret y webhook. Su disponibilidad debe ser habilitada por PlenoAgent. |
No elijas Cloud API (voz) solo porque aparece en el formulario. Úsala únicamente si PlenoAgent confirmó la activación y te entregó el proceso de Meta correspondiente.
Para WhatsApp (QR) puedes escoger:
- Escanear número nuevo: crea una sesión y solicita un QR.
- Usar canal existente: comparte una línea ya conectada. Debes elegir el Número existente y completar la Lista blanca; ese agente responderá solamente a esos números.
Escribe números con código de país y sin +. Ejemplo: 593991234567.
5Conectar WhatsApp
Haz clic en la fila del canal para abrirlo. En la pestaña general, busca Escanear para conectar WhatsApp.
En el teléfono de la empresa abre WhatsApp → Dispositivos vinculados → Vincular dispositivo.
Escanea el código. Si muestra Esperando código QR… demasiado tiempo, usa Regenerar QR.
Espera el estado Conectado y verifica que aparezca el teléfono correcto.
| Estado | Qué significa | Qué hacer |
|---|---|---|
| Conectado | La sesión está disponible. | Prueba un mensaje desde otro número. |
| Conectando… | La sesión está iniciando o esperando completar el enlace. | Espera unos segundos y usa Actualizar. |
| Desconectado | No hay una sesión activa. | Abre el canal y usa Reconectar. |
| Baneado | WhatsApp restringió la cuenta o la sesión no puede operar. | No insistas con envíos masivos; revisa la cuenta y contacta soporte. |
Desconectar cierra la sesión, elimina sus credenciales locales y obliga a escanear un QR nuevo. Si solo necesitas detener respuestas, pausa el chat o desactiva el canal.
Los cambios del canal se guardan al salir de un campo o cambiar una selección. Confirma ✓ Guardado. Si aparece No se pudo guardar, vuelve a intentarlo antes de cerrar.
6Modelo, medios e instrucciones
6.1Elegir el modelo
Un modelo económico consume menos créditos, pero puede seguir peor instrucciones complejas. Un modelo más capaz suele comprender mejor conversaciones largas, imágenes y solicitudes ambiguas. La lista indica cr/M, es decir, créditos por millón de tokens.
- Si el modelo no muestra capacidad de imagen, no esperes que interprete fotografías o comprobantes.
- Si no comprende audio de forma nativa, configura Modelo de transcripción de audio.
- Si dejas la transcripción vacía, una nota de voz que el modelo no pueda oír no será entendida correctamente.
6.2Escribir el Prompt del sistema
El Rol del agente es solo una etiqueta. El Prompt del sistema es el control real: define cómo habla, qué datos puede usar y qué jamás debe inventar.
Eres el asistente de atención de [NOMBRE DEL ISP].
OBJETIVO
- Ayudar con consultas de servicio, saldo, pagos y planes.
FORMA DE RESPONDER
- Responde en español claro, amable y breve.
- Haz una pregunta a la vez cuando falte información.
- No inventes precios, coberturas, fechas ni soluciones técnicas.
REGLAS
- Horario de atención humana: [HORARIO].
- Si el cliente pide una persona, usa la derivación a humano.
- Si no puedes resolver en dos intentos, deriva a humano.
- Si el caso se resolvió pero conviene que alguien lo revise, usa el seguimiento humano y continúa la conversación.
- Nunca prometas una visita o devolución sin confirmación.
DATOS DEL ISP
- Planes y condiciones: [RESUMEN O INDICACIÓN PARA USAR LA FUNCIÓN].
- Medios de pago: [DATOS].
- Contacto de emergencia: [NÚMERO].
Pregunta algo cuya respuesta no esté en las instrucciones. El comportamiento correcto es reconocer el límite, pedir el dato necesario o derivar; no improvisar.
7Funciones
En la subpestaña funciones decides qué acciones puede ejecutar la IA. Activar una función no reemplaza las instrucciones: el prompt debe indicar cuándo usarla.
| Función | Alcance | Qué permite | Requisito |
|---|---|---|---|
| Registro de Pagos | Chat | Registrar un pago y asociar una imagen de comprobante recibida en la conversación. | Módulo Finanzas configurado. |
| Consulta de Saldo | Chat | Consultar saldo, vencimiento y datos de la suscripción. | Módulo Finanzas configurado. |
| Listado de Planes | Chat | Consultar los planes disponibles sin copiarlos manualmente al prompt. | Módulo Finanzas configurado. |
| Derivación Humana | Chat | Transferir la conversación: la IA deja de responder y continúa una persona. | Ninguno. |
| Seguimiento Humano | Chat | Reportar el caso a una persona sin transferirlo: el chat no se pausa y la IA sigue atendiendo. | Ninguno. |
| Seguimiento Humano | Voz | Reportar una llamada sin transferirla ni finalizarla. | Ninguno. |
| Colgar Llamada | Voz | Permitir que el agente finalice la llamada cuando corresponde. | Siempre activo cuando hay voz. |
Los indicadores pueden mostrar Activado, Desactivado o Siempre Activo.
Derivación Humana corta la atención automática: el chat queda pausado esperando a una persona. Seguimiento Humano solo deja constancia del caso y la IA continúa la conversación. Puedes habilitar ambas y dejar que la IA elija según el caso; si prefieres que nunca deje un chat esperando, habilita únicamente Seguimiento Humano.
7.1Reportes
Cada derivación y cada seguimiento quedan registrados en la plataforma, en Registro › Reportes. La pestaña muestra un contador de reportes sin leer y, al hacer clic en una fila, el detalle del caso:
| Tipo | Qué ocurrió |
|---|---|
| Transferencia | La IA derivó el chat y dejó de responder. Requiere que una persona continúe. |
| Seguimiento | La IA reportó el caso y siguió atendiendo. No hay nadie esperando, pero conviene revisarlo. |
| Seguimiento de llamada | La IA reportó una llamada durante la atención de voz. |
7.2Notificaciones
- Número de Notificación Humana: recibe por WhatsApp una copia de cada derivación y de cada seguimiento.
- Número de Notificación de Registro de Pago: recibe el aviso cuando se registra un pago desde la conversación.
Usa código de país y número completo, sin +.
El reporte se registra en la plataforma aunque no configures ningún número: Registro › Reportes es el registro oficial y el WhatsApp es solo una copia. Configúralo si quieres el aviso inmediato en el teléfono de quien atiende; si el envío falla, el detalle del reporte lo indica y el caso no se pierde.
Antes de habilitar Registro de Pagos, prueba con un cliente de prueba y verifica el resultado en Finanzas. La IA debe contar con un comprobante válido y reglas explícitas; no debe asumir que una promesa de pago equivale a dinero recibido.
8Filtros y toma de control
8.1Filtro de Números
| Modo | Comportamiento |
|---|---|
| Todos | El agente puede responder a cualquier contacto que escriba a la línea. |
| Lista blanca | Responde solo a los Números Permitidos. Es útil para pruebas o para compartir una sesión entre agentes. |
| Lista negra | Responde a todos excepto los Números Ignorados. |
Los números se ingresan sin +. Un error en el código de país hace que el filtro no coincida.
8.2Demoras
- Retraso de Mensajes (ms): espera brevemente y agrupa mensajes consecutivos antes de consultar a la IA. El valor inicial habitual es 2000 ms.
- Demora de envío (seg, mín–máx): añade una pausa aleatoria entre mensajes salientes. También regula las difusiones y ayuda a evitar envíos demasiado rápidos.
8.3Auto-Toma de Control
Cuando está activada, si una persona responde desde la cuenta de WhatsApp conectada, PlenoAgent pausa automáticamente la IA para ese contacto durante la Duración de Auto-Pausa (min).
Mantén Auto-Toma de Control activada. Cinco minutos funciona para intervenciones breves; aumenta el tiempo si el equipo suele mantener conversaciones completas desde el teléfono.
9Llamadas con IA
En canales WhatsApp (QR), la subpestaña voz utiliza un segundo dispositivo vinculado, separado del dispositivo de chat.
En voz, usa Emparejar dispositivo de voz y escanea el QR como un dispositivo vinculado adicional.
Espera Dispositivo de voz emparejado.
Selecciona un Modelo de voz. Sin modelo, las llamadas no se contestan.
Elige una Voz y usa Probar esta voz con una frase corta. La prueba usa el modelo real y consume al menos un crédito.
Escribe el Prompt de llamadas de voz y activa Contestar llamadas con IA.
El prompt de voz debe ser breve y conversacional. No uses tablas, markdown ni listas largas: el contenido se leerá en voz alta. Si lo dejas vacío, se reutilizan las instrucciones de general.
Duración máxima de llamada (seg) limita el costo y evita llamadas abiertas indefinidamente. El rango permitido es de 30 a 3600 segundos; vacío usa el valor del servidor.
La voz necesita: módulo operativo, créditos disponibles, dispositivo emparejado, función activada y modelo de voz seleccionado. Además, la función global de voz puede depender de la habilitación de PlenoAgent.
Usa Desvincular únicamente si vas a emparejar de nuevo el dispositivo de voz.
10Chats
La subpestaña Registro › Chats permite buscar por teléfono y muestra Contacto, Canal, Última actividad y Estado.
| Estado | Comportamiento |
|---|---|
| Activo | La IA puede responder al siguiente mensaje. |
| Pausado (auto) | Una respuesta humana activó la pausa temporal. La pantalla muestra los minutos restantes. |
| Pausado (manual) | Alguien pausó el chat desde la plataforma; no se reanuda por tiempo. |
Usa el control de la fila para pausar o reanudar la IA. Al pausar manualmente, asegúrate de que una persona continuará la conversación por WhatsApp.
Haz clic en cualquier fila para abrir el detalle. A la izquierda verás la conversación. Las respuestas de IA y ejecuciones de funciones pueden abrirse para revisar:
- Request crudo y Response crudo del modelo.
- Argumentos y Resultado de una función.
Estos datos son de diagnóstico. Úsalos para saber si una mala respuesta provino del prompt, del modelo, de información faltante o de una función. No edites al cliente desde esta vista.
La eliminación es irreversible y borra el historial usado como contexto. Pausar no borra nada; elimina solo cuando el historial ya no debe conservarse.
11Llamadas
La subpestaña Registro › Llamadas agrupa por contacto: canal, última llamada, duración, total de llamadas, créditos consumidos y estado.
- Pausar IA en llamadas impide que la IA atienda llamadas de ese contacto.
- Reanudar IA en llamadas vuelve a habilitarlo.
- Actualizar vuelve a consultar el registro.
La pausa de llamadas es independiente de la pausa del chat. Si un contacto requiere atención completamente humana, revisa ambos lugares.
12Automatizaciones: Difusiones
En Automatizaciones → Difusiones puedes enviar el mismo mensaje a varios teléfonos desde un canal conectado.
Elige un canal en estado Conectado. Si no aparece ninguno, vuelve a Canales.
En Números de teléfono, escribe un número por línea, con código de país y sin
+. También se aceptan números separados por coma o punto y coma.Si Finanzas tiene clientes activos, usa Importar todos los clientes y revisa la lista antes de continuar.
Escribe el Mensaje y comprueba que no contenga información personal que corresponda a un solo cliente.
Haz clic en Enviar Difusión. La plataforma confirma cuántos mensajes quedaron en cola.
Los mensajes se envían en segundo plano, uno por uno, respetando la Demora de envío (seg, mín–máx) del canal. Las respuestas interactivas de clientes tienen prioridad sobre la difusión.
Envía solo a contactos que esperan comunicaciones del ISP. Una lista comprada, números desactualizados o demasiados mensajes similares pueden generar reportes y restricciones de WhatsApp. Una confirmación “en cola” no garantiza entrega individual.
13Operación diaria
13.1Antes de iniciar la jornada
- Confirma que los canales necesarios estén Conectado.
- Revisa que existan créditos y que el módulo esté operativo.
- Abre Registro › Chats y busca conversaciones pausadas que requieran seguimiento.
- Revisa Registro › Reportes: el contador indica los casos que la IA elevó y nadie ha leído.
- Si usas voz, confirma que el dispositivo siga emparejado.
13.2Después de cambiar instrucciones
- Espera ✓ Guardado.
- Prueba desde otro teléfono con un chat nuevo o elimina únicamente una conversación de prueba para evitar contexto anterior.
- Verifica una respuesta normal, una negativa, una derivación y cada función habilitada.
- Revisa créditos consumidos y el inspector técnico si la respuesta no fue la esperada.
13.3Cuando una persona interviene
Confirma que el chat muestre Pausado (auto) o páusalo manualmente.
Responde desde la misma cuenta de WhatsApp conectada.
Al terminar, reanuda manualmente o deja vencer la auto-pausa, según el caso.
14Diagnóstico rápido
- El canal está conectado, pero no responde.
- Confirma que esté activo, tenga Modelo IA, existan créditos y el módulo esté operativo. Revisa también Filtro de Números y el estado del chat.
- Responde a unos números y a otros no.
- Revisa Lista blanca, Lista negra y códigos de país. Si la línea se comparte con otro agente, confirma qué lista posee cada contacto.
- La IA responde encima de una persona.
- Activa Auto-Toma de Control y aumenta la Duración de Auto-Pausa (min). Verifica que la persona responda desde la misma cuenta enlazada.
- La IA permanece en silencio después de una intervención.
- Busca el contacto en Chats. Si está Pausado (manual), usa reanudar; si es automático, espera el tiempo restante o reanuda.
- No entiende notas de voz.
- El modelo principal debe admitir audio o el canal debe tener un Modelo de transcripción de audio. Revisa también los créditos.
- No interpreta una foto o comprobante.
- Selecciona un modelo con capacidad de imagen. Para pagos, habilita Registro de Pagos y confirma que Finanzas esté configurado.
- No deriva a una persona.
- Activa Derivación Humana y añade al prompt cuándo usarla. Prueba una solicitud explícita: “quiero hablar con una persona”. Si solo tienes Seguimiento Humano activo, la IA reporta el caso pero nunca pausa el chat: es el comportamiento esperado.
- La IA reporta un caso pero nadie se entera.
- Los reportes están en Registro › Reportes aunque no haya número configurado. Si esperabas el aviso por WhatsApp, revisa Número de Notificación Humana y el estado de entrega dentro del reporte.
- No contesta llamadas.
- Confirma Dispositivo de voz emparejado, Contestar llamadas con IA, un Modelo de voz, créditos y habilitación global de voz. Revisa si el contacto está pausado en Llamadas.
- No aparecen canales para una difusión.
- Las difusiones requieren un canal de WhatsApp QR conectado. Conecta o reconecta uno desde Canales.
- La difusión tarda mucho.
- Es intencional: sale en segundo plano y respeta la demora configurada. Las conversaciones activas tienen prioridad. No reduzcas la demora de forma agresiva.
- Una respuesta es incorrecta o inventada.
- Abre la fila en Chats y revisa Request crudo, Response crudo y funciones. Corrige el prompt, añade la información faltante o elige un modelo más capaz.