A REST API for SMS to Ethiopia numbers, with Ethiopia's sender rules applied automatically and every message showing the carrier that carried it. Point your SDK at ethiopia.woyra.io.
Personal data must remain inside Ethiopia under Proclamation 1321/2024. Alphanumeric sender IDs require registration with the operator via Ethio Telecom.
Opt-out keywords honoured automatically: STOP, UNSUBSCRIBE, CANCEL, END, QUIT, አቁም, ተወው.
ethiopia.woyra.ioEthiopia (in-country, Proclamation 1321/2024)
curl -X POST https://ethiopia.woyra.io/v1/messages \
-H "Authorization: Bearer $WOYRA_KEY" \
-H 'Idempotency-Key: order-4821' \
-H 'Content-Type: application/json' \
-d '{
"channel": "sms",
"to": "+251712345678",
"from": "YOURBRAND",
"body": "Your order 4821 is out for delivery.",
"routing": {"strategy": "conversion_optimized", "max_cost_usd": 0.03}
}'The same key works on every endpoint. Calling ethiopia.woyra.io applies Ethiopia's rules and, where residency requires it, keeps the data in the ethiopia region.
Alphanumeric sender IDs, registration required · billed in ETB · ethiopia data region
Ethiopia allows an alphanumeric sender but requires the name to be registered with the operators before traffic flows under it. Woyra files that registration and tells you when it is live; until then your traffic goes out on a sender that is already cleared, so nothing waits on paperwork.
A recipient in Ethiopia who replies STOP, UNSUBSCRIBE, CANCEL, END, QUIT, አቁም, ተወው is suppressed on your account immediately, and the next send to them is refused rather than delivered. That includes አቁም and ተወው, because a person opting out does so in their own language, and a system that only recognises the English word is a system that keeps sending.
Every message to Ethiopia records the carrier it went out on, the score that carrier held at the time, the reason it was chosen and what it cost. It is on the message in the API response and in your logs. Carriers are scored on whether codes are actually entered, not on whether a receipt said OK.
An account on the Ethiopia endpoint is billed in US dollars today. Billing in ETB is where this is going, and it is a real advantage when it arrives, but a converted price needs a published rate behind it and there is not one yet, so we quote one currency rather than invent a second. Funds are reserved at the published price when a message is accepted and settled when it is delivered; a message we never deliver is never charged for, and a hard spend cap you set is enforced rather than invoiced.
Ethiopia allows alphanumeric sender IDs, so a message can arrive from your brand name rather than a number. The sender ID must be registered first; Woyra files the registration and tells you when it is live.
STOP, UNSUBSCRIBE, CANCEL, END, QUIT, አቁም, ተወው. A recipient who replies with one is suppressed on your account automatically.
ETB, prepaid, with a hard spend cap you set per project.
Ethiopia (in-country, Proclamation 1321/2024)
E.164: a plus, the country code +251, then the subscriber number, as in +251712345678. Woyra strips spaces, hyphens, brackets and a leading 00, but it will not guess a missing country code, because the same digits belong to a different subscriber in every country.
ethiopia.woyra.io, though the same API key works on every endpoint Woyra runs. Which one you call decides the compliance rules applied, the currency you are billed in, and — where residency requires it — which data plane answers.