Esta página reúne los problemas que más se repiten y qué revisar en cada caso. Cada guía tiene además sus propios problemas frecuentes al final.
Un agente no responde en un canal
Revisa, en este orden:
- El agente está activo. En Trabajadores, su estado debe ser Activo, no Inactivo. Si está en pausa, haz clic en Activar en su página.
- El canal tiene ese agente. En Configuración › Canales, la fila del canal debe mostrar el nombre del agente, no Sin agente. Ver Canales.
- El canal está conectado. Su estado debe ser Activo o Conectado. Si dice Requiere atención o Configuración pendiente, avisa al equipo de Arbol.
- En WhatsApp, está en horario. Fuera del horario de atención la IA no responde y solo envía el aviso. Mira si la fila dice Cerrado.
- En WhatsApp, la IA atiende ese número. Si la fila dice IA desactivada o un porcentaje de IA menor a 100%, algunas conversaciones van directo a tu equipo.
- La IA no está en pausa en esa conversación. Si la conversación dice IA en pausa o Con el equipo, la atiende tu equipo. Ver Atender una conversación de WhatsApp.
- El número no está bloqueado. Si la conversación dice Número bloqueado, revisa Configuración › Bloqueos.
- El agente tiene instrucciones. Sin instrucciones no está listo para atender. Ver Escribir las instrucciones.
En el chat web, revisa además que el chat esté Publicado y que tu sitio esté en Sitios autorizados (ver Chat en tu sitio web).
Un agente responde algo incorrecto
- No tiene el dato. Revisa que el documento esté Indexado, Disponible para los agentes y asignado al agente. Ver Darle conocimiento.
- El dato cambió por unos días. Publica una novedad en lugar de editar documentos. Ver Novedades, plantillas y campañas.
- Inventa o promete cosas. Agrega límites claros en sus instrucciones, como “No inventes precios, plazos ni disponibilidad”.
- La respuesta se puede mejorar. Usa Mejorar respuesta en la conversación. Ver Mejorar las respuestas.
Después de cada cambio, pruébalo antes de dejarlo atendiendo.
Una herramienta falla
En la conversación, la tarjeta de la herramienta dice Falló o Denegada. En el agente, una integración puede decir Está desactivada, No responde o Ya no existe. El reporte Herramientas muestra cuántas veces falla cada una. Si la conexión con tu sistema no responde, avisa a quien administra las integraciones de tu organización o al equipo de Arbol.
No llegan los avisos o el reporte diario
Revisa que estén activados en Configuración › Organización, que los correos estén bien escritos y que guardaste los cambios. Busca en el correo no deseado. Ver Avisos y reporte diario.
Mensajes de error del Dashboard
| Mensaje | Qué hacer |
|---|---|
| “Tu sesión expiró. Vuelve a iniciar sesión.” | Inicia sesión de nuevo. |
| “No tienes permiso para hacer esto.” | Tu rol no incluye esa acción. Pide a un administrador que lo revise. |
| “Alguien más cambió esto mientras lo editabas.” | Vuelve a cargar la página y repite tu cambio. |
| “Demasiadas solicitudes seguidas.” | Espera un momento e inténtalo de nuevo. |
| “El servicio no está disponible en este momento.” | Inténtalo de nuevo en unos minutos. |
| “No encontramos lo que buscas. Puede que se haya eliminado.” | Vuelve a la lista: el elemento ya no existe o es de otra organización. |
| “Algunos datos no son válidos.” | Revisa los campos marcados en el formulario. |
Pedir ayuda
En el menú, haz clic en Soporte para escribirle al equipo de Arbol por correo o por WhatsApp. Cuéntales qué intentabas hacer, en qué página y qué mensaje viste. No envíes datos de pacientes que no hagan falta.
Si tu rol lo permite, también puedes preguntarle a Arbi, el asistente del Dashboard, por ejemplo “¿qué conversaciones escaló la IA esta semana?”.
Para desarrolladores
Si tu organización conecta sus sistemas con Raíz por la API (para crear campañas, leer conversaciones o iniciar contactos), las páginas técnicas están en Raíz para desarrolladores.