Démarrage rapide

L'API SMS d'Aureus Desk envoie des SMS transactionnels (codes de connexion, confirmations, rappels, alertes) vers les mobiles MTN et Orange du Cameroun, immédiatement ou à une date planifiée. Vous payez en FCFA, avec des crédits : 1 crédit = 1 SMS.

1. Ouvrez un compte et faites-le vérifier

Connectez-vous à l'espace Compte d'Aureus Desk (https://app.desk.aureusprime.com) avec votre compte Aureus Prime. Pour envoyer, votre identité (particulier) ou votre entreprise (organisation) doit être vérifiée dans votre compte Aureus Prime.

2. Créez une clé d'API

Dans l'espace Compte, rubrique Clés d'API, créez une clé. Elle commence par adk_sms_ et n'est affichée qu'une seule fois : copiez-la dans la configuration de votre serveur. Vous pouvez avoir 2 clés actives au plus.

3. Envoyez votre premier SMS

curl -X POST https://api.aureusprime.com/v1/sms/messages \
  -H "Authorization: Bearer adk_sms_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"to": "699123456", "text": "Votre code est 482913"}'

Réponse 202 : le SMS est en file, un crédit est réservé.

{
  "id": "5b0f2c1e-8a4d-4f7e-9c3a-1d2b3c4d5e6f",
  "status": "QUEUED",
  "to": "+237*******56",
  "operator": "ORANGE",
  "senderId": "Aureus Desk",
  "errorCode": null,
  "scheduledAt": null,
  "createdAt": "2026-11-01T10:00:00.000Z",
  "sentAt": null,
  "deliveredAt": null,
  "likelyUndelivered": false
}

Suivez ensuite sa livraison avec GET /sms/messages/:id (voir Suivre un SMS).

L'essentiel à retenir

• Base de l'API : https://api.aureusprime.com/v1
• Format : JSON en entrée et en sortie, UTF-8.
• Texte : 160 caractères en alphabet GSM, 70 dès qu'un caractère accentué hors GSM (ê, ô, ç, °…) ou un emoji apparaît ; un message plus long est refusé, jamais coupé.
• Numéros : mobiles du Cameroun ; les numéros sont toujours masqués dans les réponses.
• Erreurs : toujours la même forme, {"error": {"code", "message"}} (voir Erreurs).