Help Centre / USSD

USSD

Offer a short *code# menu that works on every phone, and receive each choice in PALMS.

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 #.

  • 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

  1. In PALMS, click Create the channel. PALMS shows the channel’s callback address.
  2. In Africa’s Talking, open USSD → Service codes.
  3. 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 seeWhyWhat to do
“The menu is too long”Over 182 charactersShorten the options
Dialling shows an errorThe callback address isn’t savedPaste it again in USSD → Service codes
Nothing arrivesThe person cancelled before choosingOnly finished sessions arrive
The code doesn’t work on a networkShared codes may not cover every operatorAsk Africa’s Talking

Still stuck?

Our team answers on WhatsApp, in English or French.

WhatsAppOpen Graphwafe