Skip to Content
BibliothequesRESTfulAPI PartenaireEnvoi & Solde 💬

Envoi de SMS & Solde

Tous les appels ci-dessous utilisent le connectionToken (ct_…) obtenu lors de l’appairage.

Envoyer un SMS

curl -X POST "https://rest.monsms.pro/v1/third-party-app/sms/send" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionToken": "ct_…",
    "message": "Bonjour, votre commande est prête.",
    "contacts": [
      { "phone": "+2250700000000", "name": "Awa" }
    ]
  }'

Réponse :

{
  "success": true,
  "data": {
    "campaignId": "…",
    "contactCount": 1,
    "creditUsed": 1,
    "blockedContacts": []
  }
}

Règles de facturation

  • 1 crédit = 1 segment SMS pour un numéro ivoirien (+225…).
  • Les numéros hors Côte d’Ivoire coûtent ×5.
  • Les messages longs sont découpés en plusieurs segments (chaque segment est facturé). Les accents peuvent forcer l’encodage UCS-2 (70 caractères/segment).

Les crédits sont réservés de façon atomique avant l’envoi. Si le solde est insuffisant, aucun SMS n’est envoyé (insufficient-credits). Si l’opérateur rejette l’envoi, la réservation est remboursée et la campagne marquée FAILED.

Lire le solde

curl -X POST "https://rest.monsms.pro/v1/third-party-app/balance" \
  -H "Content-Type: application/json" \
  -d '{ "connectionToken": "ct_…" }'
# → { "success": true, "data": { "credits": 1240 } }

Le solde renvoyé est celui du pool débité par cette connexion : le compte principal (Company) ou le client du revendeur (PartnerAppCustomer) selon le mode d’appairage. La lecture du solde n’exige pas de Sender ID assigné.

Last updated on
Appairage 🔗Webhooks 📡