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

Templates, sessions, and two-way conversations.

Do you support WhatsApp Business messaging?

Yes. Sozuri provides WhatsApp Business API access for approved senders. You can send template (HSM) messages for notifications and reply within a 24-hour session window for customer support. See the WhatsApp API docs for setup.

How do I get a WhatsApp Business sender approved?

You’ll need (1) a phone number not currently registered on WhatsApp, (2) a verified Meta Business account, and (3) a Display Name approval from Meta. Submit the number on the dashboard and our team will guide you through onboarding — usually a few business days.

What’s the difference between template and session messages?

Template (HSM): pre-approved messages for proactive notifications (e.g. order updates, OTPs). Must be approved by Meta before use.

Session: free-form replies you send within 24 hours of a customer message. After 24 hours you must restart the conversation with a template.

Pricing differs by category — see the docs for current rates.

Can I receive replies and forward them to my system?

Yes. Configure an inbound webhook in Project Settings → Webhooks. We’ll POST every incoming WhatsApp message and delivery status to your URL. See WhatsApp notifications.

Airtime topup

Send airtime to any Kenyan mobile number.

Can I send airtime to my customers?

Yes. Sozuri supports bulk and on-demand airtime topup for Safaricom, Airtel and Telkom subscribers in Kenya. You can send from the dashboard or via POST /v1/airtime/topup. Amounts are charged from your project wallet.

What’s the minimum and maximum airtime amount?

Minimum is KES 5 per recipient. Maximum per transaction depends on carrier limits (typically KES 10,000 for Safaricom). For large disbursements above your daily limit, contact our team for an uplift.

How are failed airtime topups handled?

If the carrier rejects a topup (wrong network, barred line, etc.), the amount is automatically refunded to your project wallet and the transaction is marked failed in your report. No manual reconciliation is required.

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 token in the apiKey header or as a Bearer token:

Authorization: Bearer YOUR_PROJECT_TOKEN

All endpoints are versioned under /v1/. Full reference: developer documentation.

What are the main API endpoints?
  • POST /v1/messaging — send SMS
  • POST /v1/messaging/whatsapp — send WhatsApp
  • POST /v1/messaging/sendpremium — premium / shortcode SMS
  • POST /v1/airtime/topup — airtime topup
  • POST /v1/contacts — manage contacts
  • GET /v1/status — platform health (no auth)

See the full reference at /docs.

Do you provide SDKs or Postman collections?

You can download a Postman collection from /downloadPostman. 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.