SMS sending is coming soon. This guide describes the planned RCS → SMS fallback behaviour for campaign flows. The capability detection and flow configuration concepts are final — SMS delivery will activate when the SMS channel launches. See SMS overview.
How capability detection works
Before executing a SEND node, the platform checks device capability internally (results are cached with a 4-hour TTL). If the device is not RCS-capable, the SEND node acts according to itsfallback configuration — no RCS send attempt is made.
A
404 from POST /v1/messages on a direct API send means the device is not RCS-capable. In campaign flows, the fallback logic handles this automatically — the 404 is never surfaced to the campaign execution.Fallback options per SEND node
| Option | Behavior |
|---|---|
fallback: none | Contact execution is skipped. The flow continues but no message is sent. A rcs_not_reachable event is logged and available for CONDITION branching. |
fallback: sms | Automatic SMS using the same text content. Rich card content (images, suggestions) is converted to plain text. |
fallback: sms_custom | SMS using a separate SMS template you configure on the node. Use this when your rich card content doesn’t translate well to plain text. |
Configuring fallback in the flow builder
In the campaign flow builder:- Add a SEND node and select your RCS channel and template.
- In the node settings, open Fallback and choose your option.
- For
sms_custom, select the SMS template to use when the RCS fallback fires. - Connect the node’s output edges — the flow continues to the next node regardless of which channel was used.
Billing
The fallback affects which pricing unit is applied — no RCS hold is created for a contact whose device fell back to SMS.| Scenario | Billing |
|---|---|
| RCS-capable device | RCS pricing (Basic or Single depending on content) |
| Fell back to SMS | SMS flat rate; no RCS reservation created |
Skipped (fallback: none) | No charge — execution skipped |
UsageEvent for a fallback send includes:
Rich card → SMS text conversion (fallback: sms)
When fallback: sms is set, the platform converts rich card content automatically:
| RCS content | SMS output |
|---|---|
content.text | Sent as-is |
rich_card.standalone.content.title | First line of SMS text |
rich_card.standalone.content.description | Second line |
rich_card.standalone.content.media | Omitted (SMS cannot carry images) |
suggestions (reply chips) | Omitted |
rich_card.carousel | Each card’s title — truncated to fit SMS length limit |
fallback: sms_custom with a purpose-built SMS template instead of relying on automatic conversion.
Direct API sends
When sending directly viaPOST /v1/messages, RCS capability is checked at the API layer. If the device is not capable, the API returns 404 — no automatic SMS fallback occurs. Fallback is a campaign flow feature only.
For API-driven multi-channel logic, send separately to each channel and use the 404 response to decide your own fallback path:
Related
RCS messaging types
Content shapes and billing units for RCS.
Campaigns in depth
SEND node configuration and CONDITION branching.
RCS text API
Direct API sends and the 404 not-capable response.
Multi-channel campaign path
Combining RCS and email in one flow with condition-based routing.