# Solución de problemas

> Errores frecuentes al conectar WhatsApp y enviar mensajes, y cómo resolverlos

Fuente: https://developers.plazbot.com/whatsapp/solucion-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](https://developers.plazbot.com/whatsapp/login).

**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](https://developers.plazbot.com/whatsapp/enviar-mensajes).

**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](https://developers.plazbot.com/whatsapp/conceptos).

**"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](https://webhook.site) para descartar problemas de tu servidor.

¿Sigue sin funcionar? Escríbenos a [support@plazbot.com](mailto:support@plazbot.com) con el comando que ejecutaste y el mensaje de error.