USSD Webhook

← Simulator

Africa's Talking callback (production)

Set in dashboard → Callback URL:

http://localhost/

Shared test USSD: *384*11971#

Alternate endpoint

POST https://www.ussd.sautisalama.co.ke/api/webhooks/ussd

Request (form POST, not JSON)

sessionId=ATUid_...
phoneNumber=+2547XXXXXXXX
serviceCode=*384*11971#
text=

text is empty on first dial, then cumulative inputs separated by * (e.g. 1*1*1*hello).

Response

Plain text:

• CON <message> — show menu, keep session
• END <message> — close session

Menu structure

• Main: 1 Support, 2 Tips, 3 Book, 5 Emergency, 0 Exit
• 1.x Consent → Topic → Message → Post-message / Champion
• 2.x Wellness topics → Tips → Web/app
• 3.x Date → Time → Gender → Booking ref
• 5.1 Crisis helpline

Environment

USSD_SERVICE_NAME="SAUTI SALAMA"
USSD_CRISIS_HELPLINE=1199
USSD_WEB_URL=https://app.sautisalama.co.ke
USSD_APP_URL=https://app.sautisalama.co.ke/download/app