---
title: "Problemas frecuentes en Raíz"
description: "Qué revisar cuando un agente no responde, responde mal, no llegan los avisos o el Dashboard muestra un error, y cómo pedir ayuda."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.getarbol.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Problemas frecuentes en Raíz

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:

1. **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.
2. **El canal tiene ese agente.** En **Configuración › Canales**, la fila del canal debe mostrar el nombre del agente, no **Sin agente**. Ver [Canales](/raiz/channels/).
3. **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.
4. **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**.
5. **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.
6. **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](/raiz/take-over-a-conversation/).
7. **El número no está bloqueado.** Si la conversación dice **Número bloqueado**, revisa **Configuración › Bloqueos**.
8. **El agente tiene instrucciones.** Sin instrucciones no está listo para atender. Ver [Escribir las instrucciones](/raiz/write-instructions/).

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](/raiz/web-chat/)).

## 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](/raiz/knowledge/).
- **El dato cambió por unos días.** Publica una novedad en lugar de editar documentos. Ver [Novedades, plantillas y campañas](/raiz/campaigns/).
- **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](/raiz/improve-replies/).

Después de cada cambio, [pruébalo](/raiz/test-an-agent/) 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](/raiz/notifications/).

## 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](/developers/raiz/).

Source: https://docs.getarbol.com/raiz/troubleshooting/index.mdx