Saltar al contenido principal

Referencias y sesiones

Una referencia representa una cuenta de WhatsApp (sandbox o productiva), Meta WhatsApp Business, Messenger o Facebook Page registrada en WhatsUY.

Crear referencia​

curl --location --request POST 'https://path-api-test.whatsuy.com/reference' \
--header 'Authorization: Bearer <jwt>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "Soporte principal",
  "type": "baileys",
  "sandbox": true
}'

Tipos de referencia​

  • baileys — WhatsApp Web (no oficial). Login por QR.
  • meta-cloud — Meta WhatsApp Business API (oficial). Requiere app aprobada.
  • messenger — Facebook Messenger.
  • custom — integraciones custom.

Sesión​

Una referencia tiene una sesión activa por proveedor. Endpoints:

  • POST /reference/session/start — inicia sesión y devuelve QR (Baileys) o URL de OAuth (Meta/Messenger).
  • POST /reference/session/logout — cierra la sesión.
  • GET /reference/session/status — estado actual (disconnected | connecting | connected | banned).

Vigencia y costo​

  • Cada referencia tiene un costo mensual y una vigencia.
  • Tras el pago, se le añade un mes de validez.
  • Cuando expira, las operaciones de la referencia se restringen (lectura permitida, escritura bloqueada).
  • Renová el pago desde el panel o vía POST /reference/:id/renew.

Detalle completo: api-documentation/03-modelo-referencia.mdx.