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

# Mensajes de error frecuentes

> Qué significa cada aviso y qué hacer.

## WhatsApp y envíos

| Mensaje                                                           | Qué significa                                                                                                                                               | Qué hacer                                                                                                                                                     |
| ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *131042: Business eligibility payment issue*                      | Tu cuenta de WhatsApp Business no tiene método de pago válido en Meta. Ningún mensaje saliente (plantillas, campañas, respuestas fuera de 24 h) se entrega. | Meta Business Suite → Configuración → Pagos → agregar método de pago a la cuenta de WhatsApp. Las respuestas dentro de la ventana de 24 h siguen funcionando. |
| Mensaje no enviado fuera de la ventana de 24 h                    | El cliente no te escribió en las últimas 24 horas.                                                                                                          | Usa una plantilla aprobada (campaña o API).                                                                                                                   |
| Plantilla **Rechazada**                                           | Meta no aprobó el texto.                                                                                                                                    | Revisa el motivo en Meta Business, corrige categoría, ejemplos o contenido, y crea una nueva.                                                                 |
| Plantilla **Pausada**                                             | Meta la pausó por baja calidad (bloqueos o reportes de los destinatarios).                                                                                  | Revisa contenido y audiencia; usa otra plantilla mientras tanto.                                                                                              |
| Todos los destinatarios de una campaña **Fallidos**               | Casi siempre facturación del WABA o plantilla no aprobada.                                                                                                  | Abre un destinatario y lee la columna **Error**.                                                                                                              |
| Destinatarios **Omitidos**                                        | Contacto dado de baja o sin teléfono válido.                                                                                                                | Es el comportamiento esperado; revisa el contacto si crees que es un error.                                                                                   |
| *No se pudo generar el enlace de conexión* (al conectar WhatsApp) | El servicio de conexión no respondió.                                                                                                                       | Reintenta en unos minutos; si persiste, escribe a soporte.                                                                                                    |

## Permisos y plan

| Mensaje                                                    | Qué significa                                                                                       | Qué hacer                                                                                                     |
| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| *No tienes permisos para…*                                 | Tu rol no permite esa acción.                                                                       | Pide al Owner el cambio de rol o que lo haga por ti. Ver [Usuarios y permisos](/guia/10-usuarios-y-permisos). |
| *Tu plan está completo* / *disponible en un plan superior* | Alcanzaste un límite (usuarios, departamentos, canales, funciones) o la función no está en tu plan. | **Ampliar plan** o **Ver planes**.                                                                            |
| *Alcanzaste el límite de tu plan* (conversaciones)         | Se agotaron las conversaciones del período.                                                         | Mejora el plan o espera al siguiente período.                                                                 |
| *Tu prueba terminó*                                        | La prueba gratuita venció sin suscripción; el agente deja de responder.                             | Elige un plan en Plan y facturación.                                                                          |
| *No pudimos procesar el último pago*                       | La tarjeta fue rechazada.                                                                           | **Gestionar facturación** → actualizar medio de pago.                                                         |

## Conversaciones y agentes

| Mensaje / situación                                   | Qué significa                                                                                            | Qué hacer                                                         |
| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Un agente no ve una conversación                      | No tiene asignada la etiqueta de esa conversación.                                                       | Tags → Gestionar usuarios → asignar.                              |
| *Esta conversación ya fue asignada*                   | Otro agente la tomó antes.                                                                               | Coordina con el equipo; puedes **Reasignar a mí** si corresponde. |
| *Asignada a {nombre} — No puedes enviar mensajes*     | Otro agente la tiene.                                                                                    | **Reasignar a mí** o pedirle que la libere.                       |
| *Esta no es la conversación más reciente del usuario* | Abriste un chat antiguo del mismo cliente.                                                               | Usa **Ver historial** para ir a la actual.                        |
| La IA no responde a un cliente                        | La conversación está tomada por una persona, el cliente está marcado como spam, o la prueba/plan venció. | Revisa el banner de estado, el filtro Spam y Plan y facturación.  |
| Tipo HITL **Inactivo**                                | No tiene usuarios asignados; las escalaciones no avisan a nadie.                                         | Asigna al menos una persona.                                      |

## Espacios y herramientas

| Mensaje                                                                  | Qué significa                                         | Qué hacer                                                                                   |
| ------------------------------------------------------------------------ | ----------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| *Archivos no permitidos* (Docs)                                          | Formato no soportado.                                 | Convierte a PDF, DOCX, TXT o MD.                                                            |
| *Este departamento no se puede eliminar porque tiene un agente asignado* | Regla de integridad.                                  | Elimina o mueve el agente desde Espacios antes.                                             |
| Función con estado *Sin probar*                                          | No tiene URL configurada.                             | Completa la pestaña Config y ejecuta **Probar**.                                            |
| *{status} Error* al probar una función                                   | Tu API respondió con error.                           | Revisa URL, método, parámetros y autenticador; el JSON de respuesta suele indicar la causa. |
| *No se pudo conectar. Verifica el token.* (Telegram)                     | El token de @BotFather es incorrecto o está revocado. | Genera uno nuevo en @BotFather.                                                             |
| *Es necesario crear un departamento para crear agentes*                  | La organización no tiene departamentos.               | Crea uno en Departamentos.                                                                  |
