Skip to content

Fallback Routing: SMS, WhatsApp, and RCS

Fallback Routing sends the same campaign on a backup channel when the first channel does not reach the customer the way you expect.

Example: try WhatsApp first; if the message is Failed, send SMS; if that also fails, send RCS.

Portal copy: Route failed deliveries across SMS, WhatsApp & RCS in sequence.

Portal prefix: /fallback/...

ScreenWhat you do
Fallback library (/ or /fallback-list)List, search, view, delete fallback rules. See counts by SMS / WhatsApp / RCS
Create FallbackName the rule, pick primary channel, then configure each step
Set fallback (/set-fallback)Drag-and-drop the channel order; configure message/template per step

This is not the same as an RCS capability check (whether the handset can receive RCS). Capability is documented on RCS. This page is campaign failover across channels.

What Fallback is

A fallback record has:

FieldMeaning
fallbackNameDisplay name
primaryChannelFirst channel in the sequence (SMS, WhatsApp, or RCS)
stepsOrdered list of channels
sms / whatsapp / rcsPer-channel payload (gateway, sender/bot, template, message, statuses that trigger the next hop)

You also see Active / Inactive, created date, and can View or Delete.

The rule does not send by itself. Compose still starts the primary campaign. Fallback only walks the remaining steps when a status you selected occurs.

Get ready

  1. The account must have the channels in the chain (SMS and/or WhatsApp and/or RCS).
  2. Each step needs a valid gateway / sender / bot / template for that channel — the same setup as a normal send.
  3. Keep wallet credits on every channel in the chain. A fallback hop is billed like a normal send on that channel. See Account.

Create a fallback

  1. Open Fallback Routing.
  2. Click Create Fallback.
  3. Enter Fallback Name (for example WhatsApp → SMS failover) — stored as fallbackName.
  4. Choose Primary Channel (SMS, WhatsApp, or RCS) — this is step 1 (primaryChannel).
  5. Click Proceed.
  6. On the next screen, tabs are the steps in order. Drag to reorder. Remove a step if it is not needed. Deleted steps can be dragged back from the trash area.
  7. For each step after the primary, choose when to fire (see Status triggers).
  8. Configure that step like a normal campaign (Configure each step).
  9. Save. The rule appears in the library as Active.

Status triggers

For each hop after the primary, pick the campaign statuses that should start the next channel:

Delivered, Failed, Sent, Read.

Typical pattern: trigger the next channel on Failed. Some teams also include Sent when they never receive a delivery receipt.

If the statuses you selected never occur, the next hop never sends. Example: you only selected Read, but the first hop Failed — SMS/RCS will not run.

Configure each step

StepWhat to set
SMSGateway, sender ID, text / unicode message, optional DLT template
WhatsAppConnected number, Approved template, variables / media
RCSBot (botId), template (templateName), content

Use the same quality bar as a standalone campaign. An unapproved WhatsApp or RCS template will fail that hop even if the primary send worked.

Do not put the same channel twice as the only hops (WhatsApp → WhatsApp with no SMS or RCS). A fallback is useful when the next channel is different.

Use it on compose

  1. Open SMS, WhatsApp, or RCS compose / broadcast.
  2. Turn on Enable Fallback.
  3. Pick the rule you created.
  4. Send or schedule as usual.

The platform:

  1. Sends the primary campaign as usual.
  2. Watches delivery status (Sent / Delivered / Read / Failed).
  3. If a status you selected occurs, sends the next channel in steps using that step’s template/message.
  4. Repeats for later hops if those statuses also match.

Blocked numbers and spam rules still apply on each hop.

Credits and reports

Each hop that actually sends deducts wallet credits for that channel. If the backup wallet is empty, the primary may succeed and the fallback hop fails. Check the header balance on Account.

Reports stay on each channel:

  • SMS Message / Number report
  • WhatsApp Message / Number report
  • RCS Message / Number report

There is no separate “fallback report” screen. Follow the recipient across those reports using the campaign name and number.

Typical mistakes

SituationWhat to do
Fallback enabled on compose but no rule selectedPick the Active rule from the list
Next-step statuses never matchInclude Failed (and Sent if receipts are slow)
WhatsApp / RCS step not ApprovedApprove the template before you rely on that hop
Not enough wallet on the backup channelRecharge that currency on My Wallet
Primary and backup are the same channel twiceAdd a different channel as the next hop
Confusing this with RCS capabilityCapability checks the handset; this page fails over the campaign

Next: Account for wallet and API keys, then compose on SMS, WhatsApp, or RCS.

Was this page helpful?