Sesiones
Controla sesiones de WhatsApp en Wazend: ciclo de vida, estados, QR, código de emparejamiento y más.
Una sesión representa una cuenta de WhatsApp (número de teléfono) conectada a Wazend, que puedes usar para enviar y recibir mensajes.
Ciclo de vida
Antes de poder enviar o recibir mensajes, debes iniciar una sesión y autenticarla mediante código QR o código de emparejamiento.
Estados de la sesión
STOPPED— la sesión está detenida.STARTING— la sesión está iniciando.SCAN_QR_CODE— se requiere escanear el QR o iniciar sesión mediante número de teléfono. Cada vez que se emite este estado, el QR cambia y debes volver a obtener el QR actualizado.PASSKEY_REQUIRED— WhatsApp solicita una passkey (WebAuthn) para completar el emparejamiento.PASSKEY_CONFIRMATION_REQUIRED— el usuario debe verificar un código antes de completar el emparejamiento.WORKING— la sesión funciona y está lista para usarse.FAILED— la sesión falló por un error. Suele significar que se requiere autorización de nuevo o que el dispositivo fue desconectado de la cuenta.
Sesión en estado FAILED
En estado FAILED, intenta reiniciar la sesión. Si no funciona, cierra sesión y vuelve a iniciarla.
Actualizar sesión
Actualiza una sesión con una nueva configuración completa.
PUT /api/sessions/{session}{
"name": "S0001",
"config": {
"webhooks": [
{
"url": "https://tu-servidor.com/webhook",
"events": ["message"]
}
]
}
}La sesión se reinicia
Si la sesión no está en estado STOPPED, se detendrá e iniciará con la nueva configuración.
Iniciar sesión
POST /api/sessions/{session}/startInformación
Operación idempotente: puedes llamarla varias veces; solo inicia si no está en ejecución.
Detener sesión
POST /api/sessions/{session}/stopInformación
Detener no cierra sesión ni elimina nada. Operación idempotente.
Reiniciar sesión
POST /api/sessions/{session}/restartAdvertencia
Si la sesión ya está en ejecución (no en STOPPED), se detendrá e iniciará de nuevo.
Cerrar sesión (Logout)
POST /api/sessions/{session}/logoutAdvertencia
Cerrar sesión elimina la información de autenticación y datos, pero conserva la configuración. Si la sesión está en WORKING, también quita el dispositivo de la lista de Dispositivos vinculados.
Listar sesiones
GET /api/sessionsObtener sesión
GET /api/sessions/{session}Obtener QR
Obtén el código QR para autenticar la sesión escaneando con la app de WhatsApp.
GET /api/{session}/auth/qr?format=rawUsa format=raw para obtener la cadena del código o format=image para el PNG.
Código de emparejamiento
Obtén un código numérico para vincular la sesión desde la app de WhatsApp.
POST /api/{session}/auth/request-codeObtener información del perfil (Me)
GET /api/sessions/{session}/me{
"id": "5215551234567@c.us",
"pushName": "Mi Nombre",
"reachoutTimelock": null,
"messageCapping": null
}Passkey
En algunos emparejamientos, WhatsApp solicita una passkey (WebAuthn). Los estados PASSKEY_REQUIRED y PASSKEY_CONFIRMATION_REQUIRED indican que el usuario debe completar este paso para terminar el emparejamiento.
Eventos
La sesión emite eventos que puedes recibir mediante Eventos o WebSockets. El evento principal es session.status; consulta el detalle del payload en la página de Eventos.