“Send Message” Action: Content and Options

Sending messages is one of the most common actions in RapidPro.app flows. You can send text, attach media, provide quick reply buttons (on supported channels), and control which contact addresses should receive the message. Getting these details right improves completion rates and reduces delivery issues.

Send messages that deliver cleanly (and drive replies)

Use this checklist to jump straight to the option you need.

  1. Add a Send Message action to your flow
  2. Create follow-up messages for each possible response
  3. Attach media (images, video, files)
  4. Use quick replies (supported IP messaging channels)
  5. Send to all numbers (multiple destinations per contact)
  6. Watch SMS character limits (160) and message splitting
  7. Understand Unicode impact (70-character segments)

You’re ready—test on your real channel type before publishing at scale.

Step-by-Step Process

1
Add a Send Message action to your flow

  1. Open your flow in the flow editor.
  2. Click Create Message to add a new node.
  3. In the node editor, select Send Message.
  4. Type the message content you want contacts to receive.
  5. Click Save (or Ok, depending on your UI) to confirm.

[CAPTURE: Flow editor showing “Create Message” clicked, with a node editor open and “Send Message” selected.]

💡
Tip: If your flow depends on a contact’s reply (e.g., “If you answered A, send message X”), place Send Message actions on each branch so the message matches the selected path.

2
Create follow-up messages for each possible response

A typical conversation pattern looks like:

  1. Ask a question (Send Message)
  2. Collect a reply (Wait for Response)
  3. Route the contact based on the reply (categories/branches)
  4. Send the next message on each branch (Send Message per outcome)

[CAPTURE: Flow showing an initial question, a Wait for Response split, and multiple branches each starting with a Send Message action.]

⚙️
Technical Detail: In a flow, Send Message actions run automatically when the contact reaches that node (they don’t require manual sending).

3
Attach media (images, video, files)

  1. Open the Send Message action editor.
  2. Click the Attachments tab.
  3. Choose the file or media you want to attach.
  4. Save the action.

[CAPTURE: Send Message editor with the “Attachments” tab selected and attachment options visible.]

Important notes about media:

  • Some channels show media inline (for example, certain social or Twilio-supported channels), while others may send a link instead.
  • Twilio MMS support depends on country and number capabilities (commonly US/Canada; verify your number supports MMS).
  • Twilio may resize images automatically to meet carrier requirements.
  • File size limits:
    • Images: up to 500 KB
    • Video: up to 20 MB
  • Some channel types (for example, Android channels) may not support image attachments.
⚠️
Warning: Always test media delivery on your real channel type. What displays inline on one channel may turn into a link on another.

4
Use quick replies (supported IP messaging channels)

Quick replies let you offer a predefined set of response buttons to contacts on supported channels (commonly IP messaging channels such as Facebook Messenger, Viber, and Telegram).

  1. In your Send Message action, enable Quick replies (if available).
  2. Add the response options you want contacts to tap.
  3. Connect your flow logic to handle each choice.

[CAPTURE: Send Message editor showing the quick replies UI with multiple response buttons configured.]

💡
Tip: Use quick replies when you want consistent, clean data (fewer typos and fewer “Other” responses).

5
Send to all numbers (multiple destinations per contact)

If a contact has multiple addresses (for example, more than one phone number or channel identity), you can choose to send to all of them.

  1. Open the Send Message action editor.
  2. Find the All Destinations (or similar) setting.
  3. Enable it to send the message to every address on the contact profile.
  4. Save the action.

[CAPTURE: Send Message editor showing the “All Destinations” option toggled on.]

⚠️
Warning: Sending to all destinations can increase costs and may create duplicate messages. Use it only when you truly need multi-address delivery.

6
Watch SMS character limits (160) and message splitting

When sending SMS, carriers typically split messages that exceed standard length limits.

  1. Look at the character counter under the message input.
  2. Keep key information within the first SMS segment when possible.
  3. If needed, split long content across multiple Send Message nodes.

[CAPTURE: Send Message editor showing a character counter beneath the message input.]

Notes:

  • Standard SMS is often 160 characters (GSM7).
  • Longer messages may be split and delivered as multiple SMS depending on the channel and carrier.
  • Some channels handle long messages differently—testing is critical.

7
Understand Unicode impact (70-character segments)

Certain characters can force SMS into Unicode mode (for example, emojis or non-Latin scripts). When this happens, the per-message segment size can drop significantly.

  • GSM7: typically 160 characters per segment
  • Unicode: often 70 characters per segment
⚙️
Technical Detail: Unicode messages are segmented differently, so the same text can cost more or arrive as more message parts when it includes emojis or non-GSM characters.

💡
Tip: If you must use emojis in SMS, keep the text short and monitor the character counter carefully.

Common Issues & Quick Fixes

My media shows as a link instead of an inline image

Problem: Contacts receive a URL instead of seeing the image directly.

Fix:

  • This can be normal for some channels—test your channel type.
  • Reduce image size to stay within limits (images ≤ 500KB).
  • If using Twilio, confirm the number supports MMS (when applicable).
SMS messages arrive split into multiple parts

Problem: One long message arrives as two (or more) messages.

Fix:

  • Keep SMS messages below the limit whenever possible.
  • Use multiple Send Message nodes to control where the split happens.
  • Avoid Unicode characters if you need the 160-character GSM7 limit.
Quick replies don’t appear for my contacts

Problem: You configured quick replies, but contacts don’t see buttons.

Fix:

  • Confirm the channel supports quick replies (typically IP messaging channels).
  • For SMS, quick replies usually won’t render as buttons—use numbered instructions instead (e.g., “Reply 1, 2, or 3”).
  • Test on the target channel before launching.