Solución de problemas

Inicio de sesión

"No hay una sesión activa. Ejecuta 'plazbot login'." No hay credenciales guardadas o se borraron. Ejecuta plazbot login.

"Tu sesión no es válida o fue revocada." El token del CLI se eliminó en Configuración → Developer o venció. Ejecuta plazbot login otra vez.

"El código venció sin autorización." 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 detectamos una conexión nueva a tiempo." 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.

"No se pudo activar automáticamente." 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

"No recibimos tu mensaje en 5 minutos."

• 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 "hola", 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 --number <tu número>).
• 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.