Overview
L'envoi de SMS vers l'Arabie saoudite échoue généralement car l'identifiant de l'expéditeur n'est pas enregistré auprès du CST (anciennement CITC), le message est considéré comme du démarchage téléphonique en dehors des heures autorisées, ou le numéro ou l'encodage est incorrect. L'Arabie saoudite applique des règles strictes concernant l'enregistrement de l'identifiant de l'expéditeur et le contenu des messages : tout trafic non enregistré ou non conforme est bloqué. Enregistrez votre identifiant d'expéditeur via un canal agréé, respectez les heures de faible diffusion de messages publicitaires et formatez les numéros au format 9665XXXXXXXX.
L'identifiant de l'expéditeur n'est pas enregistré auprès du CST.
L'autorité de régulation saoudienne, la Commission des communications, de l'espace et des technologies (CST, anciennement CITC), exige que chaque identifiant d'expéditeur A2P soit enregistré. STC, Mobily et Zain KSA n'effectuent des livraisons que sur cette base. Un identifiant d'expéditeur non enregistré renvoie le code d'erreur HTTP 06 (Identifiant d'expéditeur invalide) ou est rejeté par le réseau. BroadNet gère l'enregistrement auprès de la CST : envoyez uniquement des messages avec l'identifiant d'expéditeur approuvé dans le champ sid. Les noms de paramètres (sid, mno, type) et les codes d'erreur HTTPxx de cette page sont ceux de l'API HTTP historique (/websmpp) ; sur l'API REST avec jeton Bearer (POST /sms/sendSms), les équivalents sont senderId, destinationNumber et messageType (UNICODE pour l'arabe).
- CST (ex-CITC) nécessite des identifiants d'expéditeur A2P enregistrés.
- STC, Mobily et Zain KSA effectuent des livraisons uniquement sur les routes enregistrées.
- Non enregistré → HTTP06 ou interruption réseau.
- Envoyer avec l'identifiant d'expéditeur approuvé par CST dans sid.
Contenu marketing et heures de silence
KSA sépare le trafic transactionnel et promotionnel et limite le marketing aux heures de jour autorisées. Les messages promotionnels nécessitent généralement un identifiant d'expéditeur enregistré distinct et le respect de la possibilité de se désabonner. Un message promotionnel envoyé avec un identifiant d'expéditeur transactionnel ou en dehors des heures autorisées peut être filtré. Le trafic transactionnel doit être strictement informatif, le marketing doit être effectué auprès d'une liste d'abonnés ayant donné leur accord et l'identifiant d'expéditeur approprié doit être utilisé pour chaque flux.
- Les aspects transactionnels et marketing sont traités séparément.
- Le marketing est limité aux heures de jour autorisées.
- Le trafic promotionnel nécessite un identifiant d'expéditeur distinct et une option de désabonnement.
- N’envoyez pas de contenu promotionnel sous un identifiant d’expéditeur transactionnel.
Format numérique et encodage arabe
Saisissez les numéros de destination dans mno au format indicatif pays 966 suivi du numéro national (chiffres uniquement), sans les 0, + ni 00 initiaux ; sinon, vous recevrez une erreur HTTP 09 (Adresse de destination invalide). Pour le contenu arabe, utilisez `type=4` (70 caractères par segment) ou `type=2` pour l'Unicode ; `type=1` corrompt l'arabe. Envoyez les données encodées en UTF-8 et URL.
- Format : 966 + numéro national, chiffres uniquement (ex. 9665XXXXXXXX).
- Nombres mal formés → HTTP09.
- Arabe : type=4 (70 caractères) ; Unicode : type=2 ; jamais type=1 pour l'arabe.
- Le corps du texte doit être encodé en UTF-8 et en URL.
Confirmer la livraison et le solde
Vérifiez le DLR avant de conclure à la réussite : DELIVRD vs UNDELIV, en comparant par MessageId ou BatchId, via votre webhook ou une récupération de l'état (API HTTP historique : /websmpp/websmsstatus). Si un lot entier ne parvient pas à être acheminé, vérifiez les crédits (HTTP18 indique un solde insuffisant) et assurez-vous que la route et l'identifiant de l'expéditeur sont approuvés pour KSA.
- Consultez le statut DLR (LIVRAISON / NON LIVRÉE).
- Récupérez le statut à la demande (API HTTP historique : /websmpp/websmsstatus) si les webhooks ne sont pas configurés.
- L'échec d'un lot entier peut être dû à HTTP18 (crédits insuffisants).
- Veuillez reconfirmer que l'identifiant de l'expéditeur est approuvé par CST pour l'Arabie saoudite.