Solución de problemas

Cuando algo falla en FlujosChat, casi siempre hay una causa concreta y una señal en el panel que la delata: el número está pausado o desconectado, Meta rechazó el envío, la ventana de 24 horas venció, el bot está pausado, el flujo no coincide o se acabó el saldo de IA. Usa esta guía para revisar primero la causa real y luego el ajuste.

Mensajes y WhatsApp

No me llegan los mensajes de los clientes

Lo que está pasando de verdad: el número está pausado o desconectado en FlujosChat, o Meta no está enviando los eventos. Empieza por Configuración → Integraciones → WhatsApp.

• Si la tarjeta del número dice Número pausado por ti, pulsa Reanudar. Mientras está pausado, los mensajes que llegan se descartan: no se guardan para después.
• Si dice WhatsApp desconectado — el token de Meta expiró, vuelve a conectar con Conectar WhatsApp Business.
• Comprueba que el número tiene WhatsApp activo y que el cliente escribe al número conectado.
• Si conectaste con el botón, FlujosChat configura el webhook por ti. Si usaste la configuración manual, revisa en Meta que el webhook tenga suscrito el campo de mensajes, que la WABA esté suscrita a la app y que el token, Phone Number ID, WABA ID y App Secret correspondan a la misma app.
• En Telegram, abre su tarjeta en Integraciones y pulsa Comprobar. En Instagram, la tarjeta te dice si el acceso caducó o faltan permisos.
• Revisa la guía Conectar tu WhatsApp Business.

Envío un mensaje y sale «No enviado»

Lo que está pasando de verdad: FlujosChat crea el mensaje, intenta enviarlo por Meta y Meta lo rechaza, a veces en el acto y a veces unos segundos después de aceptarlo. El mensaje se marca en rojo con No enviado y, debajo, el motivo con su código.

• 131047: pasaron más de 24 horas desde el último mensaje del cliente; solo puedes enviar una plantilla aprobada.
• 131026: Meta no pudo entregarlo (número sin WhatsApp o versión antigua de la app).
• 131031: Meta bloqueó la cuenta de WhatsApp Business; el dueño de la cuenta debe revisar en Meta Business la facturación y las restricciones.
• 133010: el número no está registrado en la Cloud API de WhatsApp.
• 131056 o 130429: demasiados mensajes seguidos; espera un momento.
• Si el token de Meta expiró, el número queda desconectado en Integraciones: vuelve a conectarlo con Conectar WhatsApp Business.

No puedo escribir a este cliente (ventana de 24 h)

Lo que está pasando de verdad: la ventana de 24 horas de WhatsApp está cerrada. Fuera de esa ventana no puedes enviar texto libre; solo puedes retomar con una plantilla aprobada. Lo ves encima de la caja de texto: La ventana de Meta está cerrada, con el botón Usar plantilla.

• Comprueba cuándo fue el último mensaje entrante del cliente.
• En Instagram la ventana también es de 24 horas pero no hay plantillas: hay que esperar a que la persona vuelva a escribir. Telegram no tiene ventana.
• Si pasaron más de 24 horas, usa una plantilla aprobada desde Plantillas.
• Si estás probando, escribe primero desde el teléfono del cliente para abrir la ventana.

Bot, flujos e IA

El bot no responde / responde el bot cuando no debería

Lo que está pasando de verdad: el motor decide en este orden: bot pausado, anuncio con referral, conversación bajo IA, sesión de flujo activa, derivación a humano, enlace de Telegram con flujo, bienvenida, palabra clave o regla y, al final, la regla de respaldo. Si una condición anterior aplica, las demás no se ejecutan.

• En la ficha del cliente, la tarjeta Atención te dice quién atiende. Si dice Bot pausado, pulsa Reanudar bot en la cabecera del chat.
• Si dice Esperando a un humano, la IA o un flujo dejaron el chat para una persona y no arranca ningún flujo encima; se despeja en cuanto alguien del equipo responde.
• Si un agente atiende manualmente, pausa el bot para que no responda encima.
• Si esperas automatización, revisa el flujo en Flujos.

Un flujo no se dispara

Lo que está pasando de verdad: ningún flujo activo coincidió con el mensaje o había una sesión/estado que tenía prioridad. Las palabras clave se comparan contra el texto del cliente y el flujo de bienvenida solo entra cuando la conversación cuenta como nueva.

• Comprueba que el flujo esté activo: en la lista de Flujos, una tarjeta Inactivo se enciende con su botón ▶.
• Comprueba que el flujo tenga marcado el canal por el que escribe el cliente (WhatsApp, Instagram, TikTok, Telegram o Messenger) y, si tienes varios números de WhatsApp, que ese número esté entre los del flujo.
• Para palabra clave, revisa que el mensaje contenga una de las palabras configuradas.
• Para bienvenida, recuerda que se reactiva tras un día sin interacción reciente.
• Para anuncios, comprueba que el ID de publicación/anuncio esté asociado al flujo.

La plantilla fue rechazada por Meta

Lo que está pasando de verdad: Meta revisa la plantilla fuera de FlujosChat y puede dejarla como pendiente, aprobada o rechazada. FlujosChat solo permite enviar plantillas aprobadas.

• Sincroniza plantillas para traer el estado más reciente desde Meta.
• Revisa que el nombre use minúsculas, números y guiones bajos.
• No mezcles tipos de botones; las respuestas rápidas admiten máximo tres botones.
• Ajusta el contenido en Plantillas.

La IA no contesta o contesta mal

Lo que está pasando de verdad: la IA solo responde si el plan incluye IA, la suscripción no está bloqueada, hay saldo en modo incluido o una API key propia válida, y el equipo de IA está activo. Si algo falla, la conversación se devuelve a humanos y queda en Esperando a un humano con el motivo.

• Si arriba del panel ves la franja roja La IA está pausada: tu saldo de IA se agotó, pulsa Ver saldo de IA y recarga, o cambia a tu propia API key.
• Revisa Agentes IA → Configuración: modo, key y modelo.
• Revisa instrucciones, conocimiento y equipos en IA configuración.

Acceso y límites

No veo una sección del menú

Lo que está pasando de verdad: tu rol oculta secciones que no necesitas o no puedes administrar. El agente ve la operación diaria, los flujos en lectura y la base de conocimiento, donde puede redactar y mandar a revisión; configuración, plantillas, API keys, IA y usuarios son para propietario y administradores; facturación solo para el propietario.

• Comprueba tu rol en el pie del menú lateral.
• Pide a un propietario o administrador que revise Usuarios y roles.

Se agotó el saldo o el límite del plan

Lo que está pasando de verdad: hay dos bloqueos distintos. La suscripción puede estar inactiva, o el plan puede haber alcanzado un cupo aunque esté activo.

• Si ves pago pendiente, prueba Reintentar pago.
• Si el error menciona límite del plan, reduce recursos o cambia de plan.
• Para API pública, revisa llamadas mensuales, llamadas por minuto y API keys activas.
• Revisa Facturación, planes y límites.

Comprobación rápida

• Número activo en Integraciones: ni pausado ni con el token de Meta expirado.
• Si conectaste a mano: webhook de Meta verificado, campo de mensajes suscrito y WABA suscrita a la app.
• Motivo leído debajo de cada mensaje «No enviado».
• Ventana de 24 horas abierta o plantilla aprobada lista para usar.
• Bot reanudado si esperas automatización; bot pausado si atiende una persona.
• Flujo activo, con el canal marcado, palabra clave correcta, prioridad revisada y anuncio/referral asociado si aplica.
• Plantilla aprobada por Meta y sincronizada en FlujosChat.
• IA incluida en el plan, con saldo o API key propia válida.
• Rol correcto para la sección que intentas abrir.
• Plan activo y cupos disponibles para usuarios, flujos, plantillas, IA o API.