Help Centre

How can we help?

Common questions about Sozuri Bulk SMS, WhatsApp, Airtime, payments, and our Developer API.

Getting started

Set up your account, your first project, and send your first message.

What is Sozuri?

Sozuri is a Kenyan Communications Platform as a Service (CPaaS). We let businesses send Bulk SMS across Safaricom, Airtel and Telkom, WhatsApp messages, Premium / shortcode SMS, and airtime topups — from one dashboard or a single API.

You can create an account or read the developer docs to learn more.

How do I sign up and create my first project?

Go to /register, verify your email and phone (we send an OTP), then sign in. From the dashboard, click New Project. A project is where your sender IDs, contacts, campaigns, API keys, and billing live — you can have several (e.g. one per business unit) and invite collaborators to each.

Is there a free trial?

Yes. Every new project starts with free test credits so you can send messages to your own number and explore the dashboard before you top up. If you need a fuller evaluation, contact our team and we’ll provision a trial sender ID and additional credits.

Can I invite teammates to collaborate?

Yes. Inside a project, go to Collaborators → Invite Collaborator, enter their email and pick a role:

  • admin — full access including billing and sender IDs
  • manager — create and send campaigns, manage contacts
  • member — read-only access to reports and contacts

They’ll get an email invite link to accept.

Bulk SMS

Sender IDs, delivery, scheduling, and reporting.

How do I get a Sender ID (alphanumeric sender name)?

From your project, go to Sender IDs → Request New and submit your desired name (max 11 characters, no spaces) plus a short use-case. Kenyan mobile carriers require a one-time registration that we coordinate on your behalf. Typical turnaround is 2–5 business days across Safaricom, Airtel and Telkom.

While you wait, a default shared sender ID is enabled so you can keep testing.

Which networks do you support in Kenya?

All three major carriers: Safaricom (07xx, 011x), Airtel (073x, 078x, 0100–0102) and Telkom (077x). We route each number through the correct carrier automatically — you just upload the recipients, we handle the rest.

How quickly are messages delivered?

Submission to the carrier is typically under a second. End-to-end delivery depends on the destination network and handset; the vast majority arrive within a few seconds. During carrier congestion, very large bursts can take a few minutes to drain through.

Check live carrier health on the Status page before scheduling a large campaign.

Can I schedule messages for a future date and time?

Yes. When composing a campaign, set the Send At date and time. Times are in Africa/Nairobi (EAT, UTC+3). There is no hard maximum recipient count for a scheduled run, but very large bursts (>100k) are best split into batches for throughput.

How are SMS character counts and parts calculated?

Standard GSM-7 messages: 160 characters per part. If you use Unicode characters (e.g. emoji or non-Latin script), each part is 70 characters. Messages longer than one part are concatenated and billed per part. The composer shows a live counter as you type.

Can I upload contacts from a spreadsheet?

Yes. From Contacts → Import, upload a CSV or XLSX file. Phone numbers should be in Kenyan E.164 format (+254XXXXXXXXX); we’ll auto-correct common variations like 07... and 2547.... You can group contacts and merge personalisation fields like {{first_name}} into your message template.

Do you provide delivery reports (DLR)?

Yes. Every message has a status: queued → submitted → delivered (or failed/expired). You can view per-recipient DLRs in the campaign report, export to CSV/Excel, or receive them as webhooks — see the webhooks guide.

WhatsApp Business

Two ways to connect a number, one API for both.

Do you support WhatsApp Business messaging?

Yes, in two ways. Link a number you already use by scanning a QR code, or connect an official number through Meta's WhatsApp Business Platform. Both send and receive through the same API, POST /api/v1/whatsapp/messages, and a project can have both. See Choose a WhatsApp channel.

How do I connect an official WhatsApp number?

In the dashboard, open Project → WhatsApp. You sign in with Facebook in Meta's own window, choose or create your business portfolio and WhatsApp Business Account, and verify the phone number by SMS or call. Meta approves your display name, and bills its own per-message fees to the payment method on your WhatsApp Business Account.

What’s the difference between template and free-form messages?

Template: a message Meta approved in advance, for notifications you start yourself (order updates, reminders, codes). On the official channel it is the only way to message someone who has not written to you in the last 24 hours.

Free-form: anything else, sent within 24 hours of the customer's last message to that number. The QR-code channel has no templates and no 24-hour window.

Can I receive replies and forward them to my system?

Yes. Set an inbound webhook URL on the number in Project → WhatsApp. We POST every message the number receives to it, signed with the credentials under Manage API → Callback URLs → Webhook security, in the same shape for both channels. See Receiving messages.

Airtime topup

Not available right now.

Can I send airtime to my customers?

Not at the moment. Airtime sending is paused while we change provider: the dashboard and POST /api/v1/airtime/topup both refuse with HTTP 503, and nothing is charged. Contact us if you would like to hear when it is back.

Billing & payments

Topping up, supported methods, and invoices.

How do I buy SMS credits?

Sozuri works on a prepaid wallet. From your dashboard, open Billing → Top Up, enter the amount in KES, and pay. Credits are added to your project balance immediately on successful payment.

Which payment methods do you accept?
  • M-Pesa — STK Push from the dashboard or paybill
  • Card (Visa, Mastercard) via Paystack
  • Bank transfer for enterprise accounts — contact billing for details
How long does it take for credits to appear after payment?

M-Pesa and card payments credit your wallet instantly once the provider confirms the transaction. Bank transfers are reconciled within one business day. If a payment is debited but credits don’t appear within 10 minutes, contact billing@sozuri.net with the transaction code.

Is there volume pricing?

Yes. The per-SMS rate decreases with volume, and enterprise customers can negotiate custom rates per carrier. Contact sales for a quote based on your monthly volume.

Can I get an alert when my balance runs low?

Yes. In Billing → Low Balance Alert, set a threshold (e.g. KES 500 or 1,000 SMS remaining). When you drop below it, we’ll send an SMS and email to your account admins so you can top up before a campaign fails.

Do you provide invoices and statements?

Yes. Every topup generates a downloadable receipt under Billing → Transactions. Monthly statements and ETR-compliant tax invoices are available on request from finance@sozuri.net.

Developer API

Authentication, endpoints, and webhooks.

Where do I find my API key?

Each project has its own API key. Open the project, go to Settings → API Keys, and copy the key. Treat it like a password — never commit it to a public repository. See Authentication docs for examples.

How do I authenticate API requests?

Send your project's API key as a Bearer token (or as an apiKey field in the query string or body, never as a header), and your project's name as project. The key and the name together are the credential:

Authorization: Bearer YOUR_API_KEY with "project": "your_project_name"

Every endpoint is under https://sozuri.net/api/. Full reference: Authentication.

What are the main API endpoints?
  • POST /api/v1/messaging — send SMS
  • POST /api/v1/whatsapp/messages — send WhatsApp, from your official or QR-code number
  • POST /api/v1/voice/calls and /api/v1/voice/otp — voice calls and voice OTP
  • POST /api/v1/messaging/sendpremium — premium SMS
  • /api/v1/contacts — manage contacts
  • GET /api/v1/status — platform health (no auth)

See the full reference at /docs.

Do you provide SDKs or Postman collections?

Yes: download the Postman collection, import it, and set apiKey and project in its variables. It holds every customer API. Lightweight HTTP examples for PHP, Node, Python and cURL are in the sample code section. We don’t currently ship an official SDK — the API is small and any HTTP client works.

Are there rate limits?

Yes. The default limit is generous for typical workloads but to protect the platform we throttle sustained bursts. If you’re running >100 req/s or planning large batches, contact us to raise your project’s limit. Rate-limited requests get HTTP 429 — back off and retry with exponential delay.

How do I check if the platform is operational before a big run?

Probe GET https://sozuri.net/api/v1/status — it returns overall status plus per-carrier and per-component health, no authentication required. See the full guide on the API Status page.

Account & security

Login, OTP, and data handling.

I forgot my password — how do I reset it?

On the sign-in page, click Forgot password. We’ll email you a reset link valid for 60 minutes. If you don’t see it, check spam and that your email matches the one on the account.

Do you support two-factor authentication?

Yes. On sensitive actions (sign-in from a new device, sender ID changes, large topups) we send a one-time PIN to your registered phone or email. You can enforce OTP on every login from Account → Security.

Where is my data stored?

Sozuri data is hosted on infrastructure in Africa with backups encrypted at rest. We process personal data in line with the Kenya Data Protection Act, 2019. See the full Privacy & Data Policy for details.

How do I delete my account or export my data?

Send a request from your registered email to privacy@sozuri.net. We’ll export your project data (contacts, message history, billing) within 14 days and purge it once you confirm the export.

Support & SLA

Getting help when you need it.

How do I get integration help?

Open a ticket via the contact form or email developers@sozuri.net. Include your project ID, a request/response sample, and the timestamp — this lets us check the logs and respond faster.

What are your support hours?

Standard support is Mon–Fri, 08:00–18:00 EAT. Enterprise customers on a paid SLA have access to 24/7 phone and a dedicated WhatsApp support channel. Contact sales to discuss SLAs.

How can I report a security issue?

Please email security@sozuri.net. We treat reports confidentially and aim to acknowledge within one business day. Please don’t share details publicly until we’ve had a chance to investigate.

Where can I see if there’s an outage?

The live system status, per-carrier health and recent incidents are on the Status page. You can also subscribe to incident alerts there.

No results match your search. Try a different term or ask us directly.

Still have questions?

Our team responds quickly — usually within a few hours during business hours.

Chat on WhatsApp