Démarrage rapide

1. Récupère une clé API

Les clés se créent depuis le dashboard (Réglages → API, permission intégrations requise). Une clé ressemble à ws_live_ suivi de 40 caractères — elle n’est montrée qu’une seule fois à la création : copie-la immédiatement.

2. Vérifie qu’elle fonctionne

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

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

3. Lis tes leads

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

4. Importe des contacts

Le premier contact passe toujours par une liste + campagne (protection anti-ban) :

curl -X POST "https://app.whatsetter.com/api/v1/lists/LIST_ID/leads" \
  -H "Authorization: Bearer ws_live_TA_CLE" \
  -H "Content-Type: application/json" \
  -d '{"leads":[{"phone":"+33612345678","name":"Marie","custom_variables":{"ville":"Lyon"}}]}'

5. Envoie un message (lead déjà contacté)

curl -X POST "https://app.whatsetter.com/api/v1/messages" \
  -H "Authorization: Bearer ws_live_TA_CLE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: cmd-12345" \
  -d '{"lead_id":"LEAD_ID","text":"On se confirme pour demain 14h ?"}'

La réponse prend quelques secondes : le moteur rejoue la chorégraphie humaine (lu → en train d’écrire → envoi). L’en-tête Idempotency-Key garantit qu’un retry ne renverra jamais le message en double.