Help Centre / SMS

SMS

Send and receive text messages from the PALMS inbox through Africa’s Talking or Twilio.

SMS reaches every phone, with or without internet. PALMS sends and receives SMS through a provider you have an account with and pay directly: Africa’s Talking (best across Africa, local currency) or Twilio (worldwide). The guided setup shows each screen to open at the provider; you paste the key, PALMS checks it straight away, then sends a test SMS to your phone. It takes about 10 minutes, plus a few days if you request a sender ID with your business name.

Before you start

  • An account with Africa’s Talking or Twilio. Signing up is free; see which to choose.
  • Credit on that account to send messages. The Africa’s Talking sandbox and the Twilio trial cost nothing. See costs.
  • Your own mobile phone, to receive the test SMS.
  • Optional: a sender ID (your business name as sender). Request it early: approval takes a few days. See your sender.

Choose your provider

Africa’s TalkingTwilio
Best forKenya, Uganda, Tanzania, Rwanda, Nigeria, Ghana, Malawi, Zambia, Ethiopia and other African countriesWorldwide
Pay inLocal currency (mobile money, card)US dollars (card)
SenderSender ID (your name, outgoing only) or short codeA phone number you buy (sends and receives)
Try for freeSandbox with a phone simulatorTrial credit, only to verified numbers
Setup in PALMSPaste the key, then paste two addresses in its dashboardPaste SID and token, choose the number: the rest is automatic

You can connect both, and several accounts: each becomes its own channel.

Africa’s Talking: open your account

  1. In PALMS, click Open Africa’s Talking and log in, or sign up with your email.
  2. To try first: open the Sandbox app. Its username is always sandbox. Messages go to the simulator (a phone on the screen at simulator.africastalking.com), not to real phones.
  3. To go live: create a team, then an app in it (choose the country and currency). Note the app’s username shown on its page: you’ll paste it in PALMS.
  4. Top up the live app’s balance (Billing → Payment methods) before sending.

Africa’s Talking: create an API key

  1. In your app (sandbox or live), open Settings → API Key.
  2. Enter your account password and click Generate.
  3. Copy the key straight away: Africa’s Talking shows it only once.
  • Generating a new key stops the old one. If another tool used it, update that tool too.
  • A sandbox key works only with the username sandbox; a live key only with the live app’s username.
  • Live apps: if Settings → IP whitelisting lists addresses, PALMS’s servers must be among them, or leave it empty.

Africa’s Talking: your sender

  • Sender ID (alphanumeric): your business name, up to 11 letters or digits, e.g. WINDWOOL. Request it in SMS → Alphanumerics → Request. Each country (and sometimes each network) approves it; it takes a few days. Customers can’t reply to a sender ID.
  • Short code (e.g. 20880): a number customers can text. Request a dedicated one in SMS → Shortcodes, or a keyword on a shared short code. You need one to receive SMS in PALMS.
  • No sender ID yet? Leave it empty: messages go out from Africa’s Talking’s shared sender. You can add yours later with Reconnect.

Africa’s Talking: connect

  1. Choose Sandbox or Live.
  2. Enter the app’s username (sandbox for the sandbox) and paste the API key.
  3. Add your sender ID and short code if you have them.
  4. Click Connect. PALMS checks the key with Africa’s Talking and shows your balance. The key is stored encrypted and never shown again.

If something is wrong, the wizard explains the cause and the fix; see also troubleshooting.

Africa’s Talking: send replies to PALMS

Africa’s Talking doesn’t let other tools change its settings, so you paste two addresses yourself. PALMS shows them with Copy buttons:

  1. In your app, open SMS → SMS Callback URLs.
  2. Incoming Messages: paste the first address and save. Replies to your short code arrive in the PALMS inbox.
  3. Delivery Reports: paste the second address and save. PALMS shows when each SMS is delivered or why it failed.

The addresses are private to this channel: don’t share them. You find them again on the channel’s page in Settings → Channels.

Twilio: open your account

  1. Click Open Twilio Console and log in (or sign up; Twilio asks to verify your email and phone).
  2. Buy a number: Phone Numbers → Buy a number, tick SMS, choose the country of your customers.
  3. On the Console home page, find Account SID (starts with AC) and Auth Token (click Show).
  • Trial accounts send only to numbers you verified (Phone Numbers → Verified Caller IDs) and add “Sent from your Twilio trial account”.
  • Some countries need a registration before messages are delivered (for example A2P 10DLC in the United States). Twilio guides you in the Console.
  • Sending to a country may need to be ticked in Messaging → Settings → Geo permissions.

Twilio: connect

  1. Paste the Account SID and Auth Token.
  2. Click Find my numbers. PALMS lists the account’s numbers that can send SMS.
  3. Choose the number and click Connect.

PALMS sets the number’s “A message comes in” address to PALMS by itself, so replies arrive in the inbox, and checks every message really comes from Twilio. A number marked used elsewhere sends its messages to another tool today: connecting it moves them to PALMS. The token is stored encrypted and never shown again.

Test your connection

  1. Enter your mobile number with the country code and click Send test SMS.
  2. When the SMS arrives, reply with the code it contains: PALMS shows the reply and answers automatically. That proves both directions work.
  3. Sending with a sender ID only (no short code or number)? Replies can’t arrive: click I received it instead.

In the Africa’s Talking sandbox, use a number you added on the simulator and watch the message appear there. If nothing arrives, see the test message didn’t arrive.

Reconnect

If the key was changed or the channel shows an error, open Settings → Channels, choose the channel and click Reconnect. The same wizard asks only for the new details. Use the same account (and username or number): to switch to another one, connect it as a new channel. Conversations and history stay as they are.

Costs and limits

  • You pay the provider for each SMS, at its prices: PALMS adds nothing. Africa’s Talking and Twilio show prices per country on their websites.
  • One SMS holds 160 characters (70 with emoji or accented characters such as é in some cases). Longer messages are split into parts, each charged; PALMS stops at 1,530 characters.
  • SMS can’t carry pictures or files in PALMS.
  • People who reply STOP are unsubscribed automatically and not messaged again.
  • Campaigns: check your country’s rules on promotional SMS (hours, consent, opt-out).

Still stuck?

Our team answers on WhatsApp, in English or French.

WhatsAppOpen Graphwafe