Tu primer mensaje

Reemplazá https://api.tudominio.com por la URL base que te haya dado el proveedor del servicio.

1. Crear tu cuenta y generar una API Key

Las API Keys se generan una vez logueado como usuario (necesitás plan Pro). Este paso se hace una sola vez, después usás la API Key para todo:

# Crear la cuenta
curl -X POST https://api.tudominio.com/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"integraciones@tuempresa.com","password":"Password123!","name":"Tu Empresa"}'

# Loguearte para obtener un JWT temporal
curl -X POST https://api.tudominio.com/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"integraciones@tuempresa.com","password":"Password123!"}'

# Con el JWT del login, generar la API Key definitiva
curl -X POST https://api.tudominio.com/auth/api-keys \
  -H "Authorization: Bearer <JWT_DEL_LOGIN>" \
  -H "Content-Type: application/json" \
  -d '{"name":"integracion-produccion","permissions":["*"]}'

La respuesta incluye la key una sola vez — guardala en tu backend, no se puede volver a mostrar (solo revocar y crear una nueva).

A partir de acá, todos los pedidos van con:

x-api-key: <tu-api-key>

en vez de Authorization: Bearer. Ver Autenticación.

2. Crear una sesión de WhatsApp

curl -X POST https://api.tudominio.com/sessions \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"produccion"}'

Por defecto se vincula por QR. Si tu integración es headless (sin pantalla para escanear), usá pairing code en su lugar.

3. Vincular el dispositivo

curl https://api.tudominio.com/sessions/<sessionId>/qr \
  -H "x-api-key: $API_KEY"

Repetí el pedido cada pocos segundos hasta que status sea "connected" — mientras tanto devuelve el string del QR (qr) para que lo rendericés como imagen.

4. Crear una plantilla

curl -X POST https://api.tudominio.com/sessions/<sessionId>/templates \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"saludo","message":"{Hola|Buenas} {{nombre}}, tu recordatorio es {{fecha}}"}'

5. Programar el envío

curl -X POST https://api.tudominio.com/sessions/<sessionId>/schedules \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "<templateId>",
    "phone": "51987654321",
    "variables": {"nombre": "Juan", "fecha": "mañana"},
    "sendAt": "2026-01-01T15:00:00.000Z"
  }'

El envío no sale inmediatamente ni todos los pedidos juntos a la vez — pasan por una cola con demoras pensada para no arriesgar el número. Ver Envío masivo seguro.

Siguiente paso

• Conceptos: Programaciones para recordatorios recurrentes.
• Límites y cuotas para saber qué esperar en un envío a muchos contactos.