Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.belio.co.ke/llms.txt

Use this file to discover all available pages before exploring further.

Belio Messaging lets you send outbound notifications and customer messages over two channels:
  • SMS for broad reach and simple, fast delivery to Safaricom and Airtel mobile numbers.
  • WhatsApp for richer, template-based messaging through a WhatsApp Business Account (WABA), including structured content and better branding.
Both channels are designed for programmatic sending at scale, with optional delivery tracking via callbacks (delivery receipts).

​
Choose a messaging channel

Use SMS when you need maximum reach (OTP, alerts, short updates) and want the simplest integration: pick an SMS service, provide recipients, and send. Use WhatsApp when you need template-driven messaging (transactional updates, customer engagement, and branded communication) and you already have:

​
Common Concepts

Across SMS and WhatsApp, you will typically work with:
  • Authentication: All requests use Bearer token authentication.
  • Authorization scopes: Your API Client must include the appropriate scope for the channel you are using:
    • SMS —> message.sms.send.oneway
    • WhatsApp —> message.whatsapp.send.oneway
  • Recipients: Use phone numbers in international format (E.164), e.g. +254712345678.
  • Delivery receipts (callbacks): Optionally include receiptRequest with a correlator and callbackUrl to receive asynchronous status updates.

​
Next Steps

Choose a messaging channel to get started:

​
SMS

​
WhatsApp