MENA channels onboarding: WhatsApp and SMS
This guide walks you end to end through the Middle East and North Africa channels — WhatsApp in the Gulf, SMS everywhere, voice where it is legal — from first sender readiness through send, delivery, and the error handling you will actually see. It complements the per-channel references (WhatsApp, SMS) — those pages document the API shapes; this guide is the ordered playbook you follow the first time. If you operate across regions, run this same playbook shape in APAC (APAC channels onboarding) — only the market rules and channel picks differ.Pick the right channel per market
Do not activate every channel at once. Pick per market:
If you are unsure, start with WhatsApp in the GCC and SMS elsewhere — then add the second channel per market once the first is stable.
1. Sender and KYC readiness
Sender-identity and organization KYC gate everything downstream, so land them before you write a single message:- Complete Organization KYC onboarding — the organization profile, legal entity, and the documents a carrier-facing sender will ask you for. Saudi Arabia and the UAE are the strictest sender-identity regimes in the region; KYC holds there stall both SMS sender-id registration and WhatsApp Business Account review.
- Check Country capabilities for the exact markets you send into — it tells you whether two-way SMS, voice, and WhatsApp are open per country before you buy numbers or register sender-ids.
- Register your alphanumeric SMS sender-id per market where you intend to use one. In the GCC this is usually pre-registered with the carrier through your organization documents — budget days to weeks, not hours. In most North African markets sender-id is dynamic or numeric — receivers see a phone number, not a brand. Test sender-id behavior in each market before you bulk-send.
- For WhatsApp, connect your Business Account in WhatsApp getting started — the WABA review is where KYC and brand pages get re-checked; a mismatch there is the single most common MENA stall.
2. WhatsApp — template approval for Arabic-first markets
WhatsApp in MENA is template-first: you cannot send free-form marketing text — every outbound opens with an approved template. Plan template creation before you plan campaigns.- Open the WhatsApp template creation walkthrough — name the template, set the category (
MARKETING,UTILITY,AUTHENTICATION), and write the body. Arabic or bilingual Arabic-English templates usually pass review faster than English-only in Gulf markets, because Meta’s reviewers validate against local-language normativity — keep the body human, not transliterated. - Use the right script. Meta accepts the Arabic alphabet (plus digits and common punctuation). Avoid mixing scripts inside a single body — right-to-left and left-to-right text re-order unpredictably in variable placeholders. If you must include a Latin product name, put it in a fixed literal, not a
{{variable}}. - Keep the variable count low. Each added
{{n}}is another rejection-review vector; template variable count limits covers the failure shape. - Wait for approval before you send — no send path works until the template is
APPROVED. Rejection reasons are most often aMISLEADINGsample or a variable that does not match the sample — read WhatsApp template troubleshooting before you re-submit.
3. SMS — the send path and the errors you will actually see
SMS in MENA goes through the standard send endpoint — onePOST /api/v1/messages against your sender identity, with the body in plain text or Unicode for Arabic.
A
202 Accepted means queued; terminal delivered / failed arrive on the delivery-status webhook (or on GET /messages/{id} if you do not subscribe).
Common SMS failure shapes in MENA:
Read the full send path in Send and receive messages and the machine-readable statuses on the message row before you branch anything on label strings.
4. Quiet hours and local compliance pointers
Every compliance control on Orbit is tenant-owned and fail-open: you — not the platform — decide the windows you will not send in, and the platform applies them to your traffic only when you opt in. A few controls matter specifically in MENA:- Quiet hours — define a recipient-local sending window (for example, no marketing SMS 21:00–08:00) per market in Campaign limits and quiet hours. Because quiet hours fail open, an unset window never blocks a send — set the window only for the markets where you want one.
- Country-level requirements — Country requirements lists per-market legal duties (sender registration duties in Saudi, opt-in requirements in Egypt, voice marketing bans in North Africa). These are your obligations to fill in; Orbit’s compliance checklists make the country rules visible without hard-gating them.
- Frequency caps — use Frequency caps to avoid over-sending in markets with low SMS tolerance; caps are tenant-side and default off.
- Consent and DNC — wire opt-out handling through Consent management and DNC scrub where local law requires it.
5. Troubleshooting accordions
WhatsApp template rejected — MISLEADING or VARIABLE_MISMATCH
WhatsApp template rejected — MISLEADING or VARIABLE_MISMATCH
Arabic templates most often fail on a variable that no longer matches the approved sample. Re-check the template body and sample exactly, keep variables to one or two, and re-submit. If you need to localize, create a separate Arabic template rather than mixing languages — see WhatsApp template troubleshooting.
Sender-id shows as a phone number instead of my brand
Sender-id shows as a phone number instead of my brand
Most of North Africa does not carry regulator-guaranteed alphanumeric sender-id. Receivers see a numeric sender even where you registered one elsewhere. This is expected — register sender-id per market where required, and do not bulk-send until you have validated what a recipient actually sees. See Sender resolution errors.
Send blocked by KYC hold in Saudi / UAE
Send blocked by KYC hold in Saudi / UAE
GCC sender regimes require complete organization KYC before any sender registration. A hold means the onboarding checklist is incomplete — finish Organization KYC onboarding, then retry the send.
SMS delivered as failed — submitted_no_receipt
SMS delivered as failed — submitted_no_receipt
In North Africa the carrier DLR path is lossy;
submitted_no_receipt does not always mean the handset did not get the message. Read Message status lifecycle before you re-send — a submitted_no_receipt row can still flip to delivered.WhatsApp 24-hour window expired before my reply
WhatsApp 24-hour window expired before my reply
Inbound replies must be answered inside the 24-hour customer-service window; after it closes, you must open with a template again. Manage windows deliberately in high-volume markets — see WhatsApp 24h window.
See also
- APAC channels onboarding — the same playbook shape in APAC (LINE / WeChat).
- WhatsApp getting started — the WABA connect path.
- Send and receive messages — the cross-channel send pattern.
- Country capabilities — per-market channel coverage.