Empieza por el síntoma que ves. Cada apartado va de la causa más probable a la menos.
🔴 Mi agente dejó de responder
La causa número uno. Revísalas en este orden:
¿Te quedan conversaciones (o créditos)?
Mira abajo del menú lateral o en Inicio. Si tu cuenta cobra por conversaciones y se acabaron (incluida la cortesía), tu agente deja de abrir conversaciones nuevas: se arregla comprando un paquete, subiendo de plan o esperando la renovación. Si estás en la prueba, activa tu plan; si usas Gemini, Combinado o Claude, los paquetes no rinden: cambia a ChatGPT o DeepSeek o sube de plan.
Si tu cuenta sigue en créditos y el saldo llegó a 0, se arregla comprando créditos extra desde Suscripción, o esperando la renovación de tu ciclo.
¿El canal está conectado?
El punto de WhatsApp en la barra superior debe estar verde. Si está rojo, la sesión se cayó: vuelve a escanear el QR en Canales.
¿El interruptor general está encendido?
En Agentes, arriba, el interruptor Agentes IA debe decir Activados. Si alguien lo apagó, ningún agente responde.
¿La IA está apagada en esa conversación?
Abre el chat y mira el interruptor IA de la cabecera. Si está apagado, el agente no contesta en esa conversación, aunque todo lo demás esté bien. Es lo que pasa cuando alguien tomó el control y no lo devolvió.
¿Tu suscripción está al corriente?
Con el pago vencido la plataforma limita funciones. Revisa Suscripción.
🔴 WhatsApp se desconecta seguido
Si conectaste por QR, la sesión depende de tu teléfono. Se cae cuando:
- El teléfono se quedó sin batería o sin internet.
- Cerraste sesión desde Dispositivos vinculados.
- Cambiaste de teléfono o reinstalaste WhatsApp.
Solución inmediata: vuelve a escanear el QR desde Canales.
Solución de fondo: si tu negocio no puede permitirse esas caídas, migra a WhatsApp Business API, que no depende del teléfono.
🟠 El agente responde cosas incorrectas
| Síntoma | Causa habitual | Qué hacer |
|---|---|---|
| Inventa precios | No están en su conocimiento | Súbelos a Conocimiento del agente o a una tabla de Studio |
| Da precios viejos | Hay dos versiones cargadas | Borra el documento antiguo, no lo dejes "por si acaso" |
| Promete cosas que no haces | Faltan límites | Agrega prohibiciones explícitas en las Instrucciones |
| Suena raro o robótico | Falta tono y ejemplos | Ajusta el Tono y carga Ejemplos de mensajes |
| No pasa a un humano nunca | Sin herramienta de transferencia | Activa Transferir a Humano en sus Skills |
Para comprobar qué sabe realmente, usa Probar búsqueda en la Base de Conocimiento: si tu pregunta no devuelve nada ahí, el agente tampoco lo sabrá.
🟠 Las citas quedan a la hora equivocada
Casi siempre es la zona horaria de la empresa. Revísala en Ajustes.
Ojo al corregirla:
Cambiar la zona horaria no reacomoda las citas ya agendadas. Si ya tenías citas, revísalas una por una y avisa a los clientes afectados.
Otras causas: el servicio tiene mal la duración, o la agenda tiene un horario distinto al que creías.
🟠 No puedo escribirle a un cliente
Si ves la etiqueta Requiere plantilla, pasaron más de 24 horas desde su último mensaje. Es una regla de Meta, no de Yolani.
Necesitas una plantilla aprobada. Ver Plantillas de WhatsApp.
🟡 No encuentro una sección del menú
Tres causas, en orden de frecuencia:
- Estás en el otro espacio. Flow y Studio tienen menús distintos. Cambia con el selector de arriba a la izquierda.
- El módulo no está activo. Revisa Apps y módulos.
- Tu rol no tiene permiso. Un colaborador limitado no ve todo. Ver Colaboradores y roles.
🟡 Un contacto aparece dos veces
Pasa cuando el mismo cliente escribe desde dos números, o al importar un CSV con teléfonos sin clave de país.
Usa el botón Duplicados en Contactos: te muestra los pares sospechosos y los fusiona conservando ambos historiales.
🟡 Subí un archivo y el agente no lo usa
Revisa dónde lo subiste:
- La pestaña Archivos es para que el agente envíe el archivo al cliente.
- La pestaña Base de Conocimiento es para que el agente sepa lo que dice.
Un PDF de precios en Archivos se puede mandar, pero no se lee para responder. Ver Conocimiento del agente.
Comprueba también la métrica Con error: los documentos que no se pudieron procesar no sirven de nada.
🟡 Se me acaban las conversaciones muy rápido
Lo que más pesa es la inteligencia: con Combinado cada conversación gasta 18 veces lo de ChatGPT. Revisa en Inteligencia de tus agentes cuántas te rinde cada una. Si te escriben más personas de las que trae tu plan, subir de plan sale más barato que comprar paquetes.
🟡 Se me acaban los créditos muy rápido (cuentas en créditos)
El gasto depende del modelo que use tu agente, y la diferencia entre uno y otro es grande. Un modelo avanzado puede costar diez veces más por respuesta que uno económico.
Revisa el modelo en Agentes → tu asistente → Configuración. Ver Créditos de IA y Modelos de IA.
También ayuda: una base de conocimiento enorme se lee en cada respuesta y encarece cada mensaje. Prioriza lo importante.
🟡 No me llega el correo para recuperar la contraseña
- Revisa spam y promociones.
- Confirma que sea el mismo correo con el que te registraste.
- El enlace vence en 1 hora: si ya pasó, pide uno nuevo.
Si aún así no llega, escríbenos por Soporte.
Sigue sin resolverse
Desde la plataforma, abre Soporte (abajo en el menú lateral):
- WhatsApp de soporte: atención con una persona real en horario hábil.
- Reportar un problema: deja el caso por escrito y sigue su estado desde la misma ventana.
Cuando reportes, ayuda mucho incluir: qué esperabas, qué pasó, en qué pantalla y a qué hora aproximada.