Wazend

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}
Cuerpo
{
  "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}/start

Información

Operación idempotente: puedes llamarla varias veces; solo inicia si no está en ejecución.

Detener sesión

POST /api/sessions/{session}/stop

Información

Detener no cierra sesión ni elimina nada. Operación idempotente.

Reiniciar sesión

POST /api/sessions/{session}/restart

Advertencia

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}/logout

Advertencia

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/sessions

Obtener 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=raw

Usa 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-code

Obtener información del perfil (Me)

GET /api/sessions/{session}/me
Respuesta
{
  "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.

En esta página