Requête

POST /api/v1/messages/send
X-API-Key: rfl_live_…
Content-Type: application/json
Idempotency-Key: order-12345

{
  "providerId": "uuid-du-channel-provider",
  "to": "+2250700000000",
  "message": "Votre commande #12345 est confirmée."
}

Récupérez le providerId via GET /providers ou dans Instances du dashboard.

Réponse (202 acceptée)

{
  "messageId": "uuid",
  "status": "queued",
  "queuedAt": "2026-06-04T12:00:00.000Z"
}

Statut

GET /api/v1/messages/{messageId}
X-API-Key: rfl_live_…

Statuts possibles : queued, processing, sent, delivered, failed.

Détail des champs : Référence Messages.

Contact en base (`saveContact`)

Par défaut, l'API n'ajoute pas le destinataire à votre carnet (envoi direct au numéro).

Pour enregistrer le numéro (find-or-create) :

{
  "providerId": "uuid-du-channel-provider",
  "to": "+2250700000000",
  "message": "Votre commande est confirmée.",
  "saveContact": true
}

Si le contact existe déjà et est en opt-out, l'envoi est refusé dans tous les cas.

Bonnes pratiques

Utilisez Idempotency-Key pour éviter les doubles envois réseau.
Respectez le quota plan (token bucket partagé avec les campagnes).
Consultez les limites HTTP et les codes d'erreur.

Suite

Configurer un webhook pour être notifié à la livraison.