Use Cases
Ready-to-adapt recipes for real AfriRoute developer workflows
Use-case guides reduce blank-page friction. These are the flows developers reach for first: OTP, campaigns, notifications, chatbots, contact-center work, and payment alerts.
Docs mode
Reference and guide
Keep the task clear, the example nearby, and the next step obvious.
Send OTP
Bulk SMS
Transactional email
WhatsApp notifications
Voice callbacks
Webhook retries
Billing alerts
Use Case Example: send OTP
import requests
BASE_URL = "{BASE_URL}"
url = f"{BASE_URL}/api/v1/sms/send"
payload = {
"to": "+251900000000",
"message": "Your OTP code is 123456",
"country": "ET",
"senderId": "AFRIROUTE",
"type": "otp"
}
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())AI use cases
Add AI where developers already have a real workflow
AI recipe
AI chatbot for WhatsApp support
Create the bot, connect the channel, configure the provider, and keep webhook-driven escalation in the same documented flow.
AI recipe
AI routing for OTP delivery
Explain how verification and messaging flows benefit from route quality, latency visibility, and carrier-aware fallback behavior.
AI recipe
AI provider-backed completion
Use provider integrations to run completion or classification inside support, chatbot, or incident workflows.
AI Use Case Example: provider-backed completion
POST /api/v1/integrations/ai/services/completion
{
"provider": "openai",
"model": "gpt-4.1-mini",
"prompt": "Summarize this delivery incident for the operations team",
"context": {
"channel": "sms",
"market": "ET"
}
}