Sandbox

Avec votre clé sk_test_, l’API valide vos requêtes exactement comme en production, puis simule l’envoi. Aucun SMS ne part, aucun crédit n’est consommé. Vos webhooks reçoivent les mêmes événements qu’en production, signés de la même façon.

Les messages du sandbox partent toujours du numéro virtuel +212600000099. Le champ from est ignoré.
Un message normal passe de pending à sending, sent (après 2 s) puis delivered (après 4 s).
La clé de test ne donne accès qu’à l’envoi, l’envoi groupé et la consultation, et ne voit que les messages du sandbox.

Numéros spéciaux

Numéro `to`	Comportement simulé	Webhooks reçus
`+212600000000` et tout autre numéro	Envoyé après 2 s, livré après 4 s	`message.phone.sent`, `message.phone.delivered`
`+212600000001`	Échec après 3 s, `failure_reason` = `SANDBOX_SIMULATED_FAILURE`	`message.send.failed`
`+212600000002`	Livré, puis le destinataire répond « OUI » après 9 s	`message.phone.sent`, `message.phone.delivered`, `message.phone.received`
`+212600000003`	Jamais envoyé, statut `expired` après 60 s	`message.send.expired`

Tester une réponse entrante

curl -X POST https://api.getsms.ma/v1/messages/send \
  -H "x-api-key: sk_test_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"to": "+212600000002", "content": "Commande #8841 : 349 DH, livraison demain. Répondez OUI pour confirmer."}'

Neuf secondes plus tard, votre serveur reçoit message.phone.received avec "content": "OUI".