USSD menus work on every phone, without internet: people dial a code like *384*1234#, see your short menu, choose an option, and that’s it. Each finished session arrives in PALMS as a conversation with the person’s phone number and their choice, so your team can follow up. Through Africa’s Talking. About 10 minutes.
Before you start
- An Africa’s Talking account. The sandbox and its simulator are free for trying.
- A service code — see below.
Your service code
- Shared code (quick): a channel on a shared code, like
*384*1234#. Create it in Africa’s Talking → USSD → Service codes. In the sandbox it’s instant. - Your own code (like
*123#): needs the mobile operators’ approval and usually takes weeks. Ask Africa’s Talking.
Enter the code in PALMS exactly as people dial it, with * and #.
Your menu
- First line: a short welcome, for example Welcome! What do you need?
- Options: one per line, up to 6 (Talk to sales, Customer support, Opening hours). PALMS numbers them.
- Last screen: what people see after choosing, for example Thank you. We will contact you shortly.
A USSD screen shows about 182 characters: the wizard counts them and shows a phone preview. You can change the menu later in the channel’s settings.
Paste the address in Africa’s Talking
- In PALMS, click Create the channel. PALMS shows the channel’s callback address.
- In Africa’s Talking, open USSD → Service codes.
- Next to your code, click the edit button of Callback, paste the address and save.
Test your connection
- Sandbox: open the simulator, enter a phone number, dial your code, choose an option and finish.
- Live: dial the code from your phone.
The session appears in the wizard and in the inbox.
How it works
- Each person becomes a contact by phone number; their choice arrives as a message.
- USSD sessions end after the last screen: you can’t reply through USSD. Call back, or write by SMS or WhatsApp.
- Africa’s Talking bills sessions on your account (often free for the person dialling, depending on the code).
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| “The menu is too long” | Over 182 characters | Shorten the options |
| Dialling shows an error | The callback address isn’t saved | Paste it again in USSD → Service codes |
| Nothing arrives | The person cancelled before choosing | Only finished sessions arrive |
| The code doesn’t work on a network | Shared codes may not cover every operator | Ask Africa’s Talking |