Inicio rápido

1. Consigue una clave API

Las claves se crean desde el dashboard (Ajustes → API, permiso integraciones requerido). Una clave tiene la forma ws_live_ seguida de 40 caracteres. Se muestra una sola vez al crearla: cópiala de inmediato.

2. Comprueba que funciona

curl https://app.whatsetter.com/api/v1/me \
  -H "Authorization: Bearer ws_live_TU_CLAVE"

{
  "data": {
    "team_id": "…",
    "key": { "name": "Mi CRM", "scopes": ["leads:read", "…"] }
  }
}

3. Lee tus leads

curl "https://app.whatsetter.com/api/v1/leads?status=qualified&limit=10" \
  -H "Authorization: Bearer ws_live_TU_CLAVE"

4. Importa contactos

El primer contacto pasa siempre por una lista + campaña (protección anti-ban):

curl -X POST "https://app.whatsetter.com/api/v1/lists/LIST_ID/leads" \
  -H "Authorization: Bearer ws_live_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"leads":[{"phone":"+34612345678","name":"María","custom_variables":{"ciudad":"Madrid"}}]}'

5. Envía un mensaje (lead ya contactado)

curl -X POST "https://app.whatsetter.com/api/v1/messages" \
  -H "Authorization: Bearer ws_live_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: cmd-12345" \
  -d '{"lead_id":"LEAD_ID","text":"¿Confirmamos mañana a las 14h?"}'

La respuesta tarda unos segundos: el motor repite la coreografía humana (leído → escribiendo → envío). La cabecera Idempotency-Key garantiza que un reintento nunca enviará el mensaje dos veces.