Overview
SMS nach Saudi-Arabien (KSA) schlagen häufig fehl, weil die Absenderkennung nicht bei der CST (ehemals CITC) registriert ist, die Nachricht als Werbung außerhalb der zulässigen Zeiten erkannt wird oder die Nummer bzw. die Kodierung fehlerhaft ist. Saudi-Arabien setzt strenge Regeln für die Registrierung von Absenderkennungen und die Inhalte durch – nicht registrierter oder nicht konformer SMS-Verkehr wird blockiert. Registrieren Sie Ihre Absenderkennung über einen lizenzierten Dienst, beachten Sie die Werbe-Ruhezeiten und formatieren Sie Ihre Telefonnummern im Format 9665XXXXXXXX.
Absenderkennung nicht beim CST registriert
Die saudische Regulierungsbehörde für Kommunikation, Raumfahrt und Technologie (CST, ehemals CITC) schreibt die Registrierung jeder A2P-Sender-ID vor. STC, Mobily und Zain KSA liefern ausschließlich auf dieser Basis. Eine nicht registrierte Sender-ID führt zu einem HTTP-Fehler 06 (Ungültige Sender-ID) oder wird vom Netzwerk verworfen. BroadNet übernimmt die CST-Registrierung – senden Sie ausschließlich mit der genehmigten Sender-ID in der SID. Die Parameternamen (sid, mno, type) und HTTPxx-Fehlercodes auf dieser Seite gehören zur Legacy-HTTP-API (/websmpp); in der REST-API mit Bearer-Token (POST /sms/sendSms) heißen die Entsprechungen senderId, destinationNumber und messageType (UNICODE für Arabisch).
- CST (ehemals CITC) erfordert registrierte A2P-Absender-IDs.
- STC, Mobily und Zain KSA liefern nur auf registrierten Routen.
- Nicht registriert → HTTP06 oder Netzwerkabbruch.
- Senden Sie die Nachricht mit der von CST genehmigten Absender-ID in sid.
Marketinginhalte und Ruhezeiten
KSA trennt Transaktions- und Werbe-Traffic und beschränkt Marketing auf zulässige Tageszeiten. Werbe-Nachrichten benötigen in der Regel eine separate registrierte Absenderkennung und eine gültige Opt-out-Option. Werbe-Nachrichten, die unter einer Transaktions-Absender-ID oder außerhalb der zulässigen Zeiten versendet werden, können gefiltert werden. Transaktions-Nachrichten sollten ausschließlich informativen Charakter haben, Marketing-Nachrichten sollten nur an Empfänger mit Opt-in versendet werden, und für jeden Datenstrom sollte die korrekte Absenderkennung verwendet werden.
- Transaktions- und Marketinggeschäfte werden getrennt behandelt.
- Das Marketing ist auf die zulässigen Tageszeiten beschränkt.
- Für Werbe-Traffic ist eine eindeutige Absenderkennung und eine Opt-out-Option erforderlich.
- Versenden Sie keine Werbeinhalte unter einer Transaktions-Absender-ID.
Zahlenformat und arabische Kodierung
Geben Sie die Zielrufnummer in mno als Ländervorwahl 966 plus die nationale Rufnummer an (nur Ziffern, führende 0, + oder 00 weglassen) – andernfalls erhalten Sie die Fehlermeldung HTTP09 (Ungültige Zieladresse). Verwenden Sie für arabische Inhalte type=4 (70 Zeichen pro Segment) oder type=2 für Unicode; type=1 führt zu fehlerhaften arabischen Daten. Senden Sie UTF-8-kodiert und URL-codiert.
- Format: 966 + nationale Vorwahl, nur Ziffern (z. B. 9665XXXXXXXX).
- Fehlerhafte Nummern → HTTP09.
- Arabisch: Typ=4 (70 Zeichen); Unicode: Typ=2; niemals Typ=1 für Arabisch.
- Der Nachrichtentext muss UTF-8-kodiert und URL-codiert sein.
Lieferung und Restbetrag bestätigen.
Prüfen Sie die DLR, bevor Sie von einem Erfolg ausgehen: DELIVRD vs. UNDELIV, abgeglichen anhand der MessageId oder BatchId, über Ihren Webhook oder einen Statusabruf (Legacy-HTTP-API: /websmpp/websmsstatus). Falls die Übertragung eines gesamten Batches fehlschlägt, überprüfen Sie das Guthaben – HTTP18 bedeutet unzureichendes Guthaben – und stellen Sie sicher, dass Route und Absender-ID für KSA zugelassen sind.
- Lesen Sie den DLR-Status (DELIVRD / UNDELIV).
- Den Status bei Bedarf abrufen (Legacy-HTTP-API: /websmpp/websmsstatus), falls keine Webhooks eingerichtet sind.
- Ein Fehler, der zum Ausfall des gesamten Batches führt, kann durch HTTP18 (unzureichendes Guthaben) verursacht werden.
- Bitte überprüfen Sie erneut, ob die Absender-ID von CST für Saudi-Arabien zugelassen ist.