Overview
L'invio di SMS verso l'Arabia Saudita (KSA) di solito non va a buon fine perché l'ID del mittente non è registrato presso il CST (precedentemente CITC), il messaggio viene interpretato come marketing inviato al di fuori degli orari consentiti oppure il numero o la codifica sono errati. L'Arabia Saudita applica rigide norme di registrazione dell'ID del mittente e di contenuto: il traffico non registrato o non conforme viene bloccato. Registra l'ID del mittente tramite un canale autorizzato, rispetta gli orari di silenzio per il marketing e formatta i numeri come 9665XXXXXXXX.
ID mittente non registrato presso il CST
L'autorità di regolamentazione dell'Arabia Saudita, la Communications, Space & Technology Commission (CST, precedentemente CITC), impone la registrazione di ogni ID mittente A2P e STC, Mobily e Zain KSA effettuano le trasmissioni solo su questa base. Un ID mittente non registrato restituisce HTTP06 (ID mittente non valido) o viene scartato dalla rete. BroadNet gestisce la registrazione presso la CST: inviare solo con l'ID mittente approvato. I nomi dei parametri (sid, mno, type) e i codici di errore HTTPxx in questa pagina sono quelli dell'API HTTP legacy (/websmpp); nell'API REST con token Bearer (POST /sms/sendSms) gli equivalenti sono senderId, destinationNumber e messageType (UNICODE per l'arabo).
- CST (ex CITC) richiede ID mittente A2P registrati.
- STC, Mobily e Zain KSA effettuano consegne solo sui percorsi registrati.
- Non registrato → HTTP06 o interruzione di rete.
- Inviare utilizzando l'ID mittente approvato da CST in sid.
Contenuti di marketing e orari di silenzio
KSA separa il traffico transazionale da quello promozionale e limita le attività di marketing alle ore diurne consentite. I messaggi promozionali, in genere, richiedono un ID mittente registrato distinto e il rispetto dell'opzione di disiscrizione. Un messaggio promozionale inviato con un ID mittente transazionale o al di fuori delle ore consentite può essere filtrato. Il traffico transazionale deve essere esclusivamente informativo, le attività di marketing devono essere indirizzate a liste di contatti che hanno dato il proprio consenso esplicito e l'ID mittente corretto deve essere utilizzato per ciascun flusso di comunicazioni.
- Le attività transazionali e quelle di marketing vengono trattate separatamente.
- Le attività di marketing sono limitate alle ore diurne consentite.
- Il traffico promozionale necessita di un ID mittente univoco e di un'opzione di disiscrizione.
- Non inviare contenuti promozionali utilizzando un ID mittente transazionale.
Formato numerico e codifica araba
Inserire i numeri di destinazione in mno come prefisso internazionale 966 seguito dal numero nazionale, solo cifre, omettendo eventuali 0, + o 00 iniziali; in caso contrario, si otterrà l'errore HTTP09 (Indirizzo di destinazione non valido). Per i contenuti in arabo utilizzare type=4 (70 caratteri per segmento) o type=2 per Unicode; type=1 corrompe l'arabo. Inviare in UTF-8 e con codifica URL.
- Formato: 966 + numero nazionale, solo cifre (es. 9665XXXXXXXX).
- Numeri non validi → HTTP09.
- Arabo: tipo=4 (70 caratteri); Unicode: tipo=2; mai tipo=1 per l'arabo.
- Il corpo del messaggio deve essere in formato UTF-8 e codificato in URL.
Conferma consegna e saldo
Prima di dare per scontato il successo, verifica il DLR: DELIVRD vs UNDELIV, abbinati tramite MessageId o BatchId, tramite il tuo webhook o un recupero dello stato (API HTTP legacy: /websmpp/websmsstatus). Se un intero batch non viene trasferito, verifica i crediti (HTTP18 indica un saldo insufficiente) e conferma che il percorso e l'ID mittente siano approvati per l'Arabia Saudita.
- Leggi lo stato del DLR (CONSEGNA / NON CONSEGNA).
- Recupera lo stato su richiesta (API HTTP legacy: /websmpp/websmsstatus) se i webhook non sono configurati.
- L'errore dell'intero batch può essere dovuto a HTTP18 (crediti insufficienti).
- Conferma nuovamente che l'ID del mittente sia approvato da CST per l'Arabia Saudita.