Solución de problemas

Cuando algo falla en FlujosChat, casi siempre hay una causa concreta: WhatsApp no entregó el webhook, Meta rechazó el envío, el bot está pausado, el flujo no coincide o tu plan bloqueó una acción. 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: Meta no está enviando eventos a FlujosChat, o los eventos no pasan la validación del webhook. Puede ocurrir aunque la URL del webhook responda bien.

• Comprueba que el número tiene WhatsApp activo y que el cliente escribe al número conectado.
• Revisa en Meta que el webhook tenga suscrito el campo de mensajes y que la WABA esté suscrita a la app.
• Verifica que el token, Phone Number ID, WABA ID y App Secret correspondan a la misma app.
• Revisa la guía Conectar tu WhatsApp Business.

Envío un mensaje y sale como fallido

Lo que está pasando de verdad: FlujosChat crea el mensaje, intenta enviarlo por Meta y Meta lo rechaza. Entonces el mensaje queda con estado fallido.

• Comprueba si el error menciona ventana de 24 horas, token vencido o proveedor Meta.
• Revisa que haya una configuración de WhatsApp activa para la empresa.
• Si el token expiró, reconecta WhatsApp desde configuración.

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.

• Comprueba cuándo fue el último mensaje entrante del cliente.
• 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, bienvenida, palabra clave o regla. Si una condición anterior aplica, las demás no se ejecutan.

• En la conversación, revisa si el botón dice Reanudar Bot.
• 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.
• 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.

• Revisa Agentes IA → Configuración: modo, key y modelo.
• En facturación, comprueba el saldo de IA incluida o cambia a tu propia API key.
• 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 operación diaria y flujos en lectura; 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

• WhatsApp conectado con token, Phone Number ID, WABA ID y App Secret correctos.
• Webhook de Meta verificado, campo de mensajes suscrito y WABA suscrita a la app.
• 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, 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.