Aller au contenu
Aureus PrimeDocs

Guides

Planifier un SMS

Ajoutez scheduledAt à l'envoi pour choisir la date et l'heure de départ, jusqu'à 30 jours à l'avance.

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": "Rappel : votre rendez-vous est demain à 10 h.", "scheduledAt": "2026-11-02T08:00:00+01:00"}'

Règles

  • Format : date ISO 8601 avec fuseau : 2026-11-02T08:00:00+01:00 (heure du Cameroun) ou 2026-11-02T07:00:00Z. Sans fuseau : refusé.
  • Dans le futur, et 30 jours au plus après l'appel. Sinon : 422 SCHEDULE_INVALID.
  • Crédit réservé dès la planification.
  • Le SMS reste au statut QUEUED jusqu'à sa date, puis part comme les autres. La réponse et GET /sms/messages/:id renvoient scheduledAt.

Annuler un SMS planifié

DELETE https://api.aureusprime.com/v1/sms/messages/:id

Tant que le SMS n'est pas parti, il passe à CANCELLED et le crédit vous est rendu. Réponse 200 avec l'état du message.

Code Cas
409 NOT_CANCELLABLE Le SMS n'était pas planifié, ou il est déjà parti
404 NOT_FOUND Le message n'appartient pas à votre compte

Conseil

Pour un code à usage unique, n'utilisez pas la planification : envoyez-le tout de suite avec "sensitive": true.