Reach every phone in Rwanda.
One API for verification codes, alerts and notifications, with a delivery receipt for every message. 15 RWF per segment, paid in francs.
One request per message.
POST the number and the text with an API token that can send SMS. Add an idempotency key and a retry never sends twice.
Read the messaging API$ curl https://api.bweze.com/v1/messages \ -H "Authorization: Bearer $BWEZE_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: order-1042" \ -d '{"to": "+250788123456", "body": "Your code is 482910"}' ✓ {"id": "…", "status": "sent", "segments": 1}
Messages you can account for.
Delivery receipts
Every message keeps the receipts the network sends back: delivered, failed, expired or rejected, with the network's reason.
Opt-outs handled
A reply of STOP puts the number on your opt-out list and the API stops messaging it; START takes it off.
Paid per segment
15 RWF a segment. GSM-7 fits 160 characters in one segment; an emoji switches the message to UCS-2, which fits 70. How length sets the price.
No sending on credit
Top up with mobile money. Each send holds its cost against your balance, so a message is refused, never sent on credit.
Asked before sending.
How is an SMS billed?
Per segment. A message in the GSM-7 alphabet fits 160 characters in one segment and 153 per segment when it is longer. A message with a character outside it, such as an emoji, uses UCS-2, which fits 70 characters in one segment and 67 per segment when longer. A send is refused before it costs anything if it would be over 10 segments.
Do I find out whether a message arrived?
Yes. Each message records the delivery receipts the network sends back, so you can see whether it was delivered, failed, expired or was rejected, and the network’s reason.
What happens when someone replies STOP?
Their number joins your workspace’s opt-out list and the API refuses to message it with recipient_opted_out. Replying START takes it off the list. You can also add or remove a number yourself.
Can I retry a send without sending twice?
Yes. Send an idempotency key with the message; a retry with the same key returns the first result instead of sending again.
How do I pay?
Top up your BWEZE wallet with mobile money. Each send holds its cost against your balance, so a message is refused rather than sent on credit when the balance is too low.
- Delivery receipts
- Stop and start handled
- Billed per segment
- No sending on credit
- Top up with mobile money