Solución de problemas

Inicio de sesión

"You are not signed in." No hay credenciales guardadas o se borraron. Ejecuta plazbot login.

"Your session is invalid or was revoked." (o "Your session is invalid or expired.") El token del CLI se eliminó en Configuración → Developer o venció. Ejecuta plazbot login otra vez.

"The code expired before it was authorized." / "Login timed out." Pasaron más de 10 minutos sin presionar Autorizar en el navegador. Ejecuta plazbot login otra vez.

El navegador no se abrió. Copia el link que muestra la terminal y ábrelo manualmente. En servidores sin interfaz gráfica usa plazbot login --no-browser o variables de entorno.

La pantalla "Autorizar CLI" dice "Enlace no válido o vencido". El link es de un intento anterior. Vuelve a ejecutar plazbot login y usa el link nuevo.

Conexión del número

"No new connection was detected in time." El registro de Meta no se completó en 10 minutos. El link sigue siendo válido 7 días: termina el registro y vuelve a ejecutar plazbot whatsapp setup o plazbot whatsapp connect.

"Could not activate it automatically. Activate it in the panel → Integrations." Activa el número en el panel, Configuración → Integraciones → WhatsApp.

No aparece mi número en setup. Los números conectados por QR no oficial no se muestran. Conecta el número con WhatsApp API o WhatsApp Business (coexistencia).

Envío de mensajes

"The contact does not exist in the database." Estás enviando texto libre a un número que nunca te escribió. Pídele que te escriba primero o usa una plantilla aprobada.

El texto libre no llega aunque el contacto existe. Probablemente pasaron más de 24 horas desde su último mensaje. Usa una plantilla. Ver ventana de 24 horas.

"The selected template is not approved." / "is not active." La plantilla está pendiente, rechazada o desactivada. Revísala en el panel, módulo Marketing → Plantillas.

"The template does not exist in the database." El nombre de la plantilla no coincide. Usa el nombre exacto de la plantilla en el panel.

Prueba de setup

"Your message did not arrive within 5 minutes." Revisa lo siguiente:

• Verifica que escribiste al número correcto (el que aparece en el paso 3).
• Verifica que el celular que escribiste en el asistente es el mismo desde el que enviaste "hello", con código de país.
• Verifica que el número está activo en Configuración → Integraciones.

Me respondió un agente IA además del mensaje de prueba. El número tiene un agente asignado. Es normal; para una prueba limpia usa un número sin agente.

Webhook

No me llegan los mensajes al webhook.

• La URL debe ser https:// y responder 200.
• Verifica que registraste el webhook en el número correcto (plazbot whatsapp register-webhook -p <tu número> -u <url>).
• Prueba con una URL de webhook.site para descartar problemas de tu servidor.

¿Sigue sin funcionar? Escríbenos a support@plazbot.com con el comando que ejecutaste y el mensaje de error.