RCS errors and failed messages: causes and fixes

RCS problems in Fast2SMS show up in three places: an error when you click Send in Bulk RCS, an error reply from the RCS API, or a Failed or Non-RCS status in the delivery report. This page lists every RCS error message we know of, what it means and how to fix it.

Find the exact text you see in the tables below. If you still need help, contact support with the Request ID of the campaign from the RCS report.

Errors when you send from Bulk RCS

These appear as a message on the Bulk RCS page after you click Send or Schedule. Nothing is sent and nothing is charged.

Error message What it means Fix
Your RCS brand is pending approval. You cannot send RCS messages until it is approved. Your brand or bot is not approved yet. Wait for approval. The registration form says this can take 3-7 days.
Promotional messages are allowed from 7:00 AM to 10:00 PM You tried to send from a promotional bot outside these hours. Send between 7:00 AM and 10:00 PM, or schedule it. A night schedule moves to 7:01 AM.
Minimum one contact or one group requried. No numbers were added. Add numbers under Send To: List, Address Book or CSV File.
Message length should be less than 3000 characters. The message is too long. Shorten it to under 3,000 characters.
Insufficient wallet balance, you need at least ₹X to send this RCS Message campaign. Your wallet does not cover the whole campaign. Click Add Amount, recharge and send again.
Your sheet was not found, please upload again. The uploaded file could not be read. Upload the CSV file again.
Invalid column for contacts, column not found in sheet The column you chose for numbers is not in the file. Choose the column that has the mobile numbers.
Sheet must contain minimum one contact no. The file has no numbers. Check the file and upload it again.
Invalid Mobile Number in (column name). The first number in that column is not a valid Indian mobile number. Use 10-digit numbers starting with 6, 7, 8 or 9. Remove headings or blank rows at the top.
Bulk RCS page with Send To set to CSV File, a Sample CSV link and an upload box for a CSV file of up to 20MB
Download the Sample CSV to get the file format right.

Tip: Duplicate and invalid numbers are removed before sending and shown in the confirmation popup, so a few bad numbers in a list do not stop the campaign. The “Invalid Mobile Number” error only appears when the column itself looks wrong.

Errors from the RCS API

The RCS API returns HTTP 400 with "return":false, a list of the fields with problems in errors_keys, and the messages in errors. Check errors_keys first to see which field to fix.

{"return":false,"errors_keys":["bot_id"],"errors":{"bot_id":["Invalid or inactive RCS bot"]}}
Error or field What it means Fix
Invalid or inactive RCS bot The bot_id is wrong, belongs to another account, or the bot is not approved and active. Copy the Bot ID from RCS Manager > Bots and check its Status is Active.
The bot id is invalid. The bot_id value is not a plain text ID. Send the Bot ID as a string, exactly as copied.
Mobile Number format is invalid. The to number is not a valid Indian mobile number. Send one 10-digit number starting with 6 to 9. +91 or 91 in front is accepted.
type Missing or not one of plain, rich, media, carousel. Set type to one of these four values.
message Missing for plain or rich, or over 3,000 characters. Add the text and keep it under 3,000 characters.
title Over 100 characters. Shorten the rich card title.
media_url Missing for type media, or not a valid URL. Use a full public link starting with https://.
suggestion_text, suggestion_url, suggestion_phone Button text over 25 characters, or the URL or phone missing for the button type. Keep button text to 25 characters. Add suggestion_url for openUrl, suggestion_phone for dial, and latitude/longitude for viewLocation.
cards Fewer than 2 or more than 10 cards, or a card without title or description. Send 2 to 10 cards, each with a title and description.
Authentication errors (HTTP 401) The API key is missing, wrong or disabled. Send your key in the authorization header. See the API error codes guide.
RCS Manager Bots list with Bot IDs, copy icons, categories, today's usage and Active or Inactive status
Copy the Bot ID from here to avoid “Invalid or inactive RCS bot”.

Failed and Non-RCS in the delivery report

These are per-number results after the campaign is sent. Open Delivery Report > RCS Report, click the campaign and read the Description column in Delivery Details. Every number is charged when the campaign is sent, and Failed and Non-RCS numbers are refunded automatically within 48 hours.

Status and description What it means Fix
Non-RCS: Number is unreachable / not RCS enabled The phone cannot receive RCS (RCS turned off, no supported app, or the number is not reachable on RCS). Nothing to fix on your side. Reach these customers by SMS or WhatsApp. The amount is refunded.
Failed: Not Reachable The phone did not come online within 6 hours, so the message expired. Send again later. The amount is refunded.
Failed: Monthly Limit Reached (4 Promo RCS Allowed) The number already got 4 promotional RCS this month. Wait for next month. Do not move offers to a transactional bot. The amount is refunded.
Sent (for a long time) The network accepted the message but the phone has not confirmed delivery. Click Refresh later. Sent is not refunded because the network accepted it.
Pending The message is still being processed. Wait a few minutes and refresh.
Rejected or another error text The message was not accepted for delivery. Contact support with the Request ID shown at the top of Delivery Details.
RCS Reports for the last 30 days with cards for Total, Delivered, Failed, Sent and Pending, an activity chart, a Total RCS donut including Non-RCS, and campaign rows with Download buttons
The Total RCS donut shows Delivered, Non-RCS, Failed, Sent and Pending at a glance.

Other RCS errors

  • Registration form errors (website, domain email, GST certificate, opt-in form): see the RCS brand registration guide below.
  • Inbox Settings errors (out of office text, timezone, working day, delay time): see the RCS auto reply guide below.
  • Live Chat, RCS Manager or Inbox Settings is greyed out: you do not have an approved, active bot yet.

Frequently asked questions

Why did my RCS message fail?

Open the campaign in the RCS report and read the Description. The most common reasons are Non-RCS phones, phones that stayed offline for 6 hours, and the 4 promotional RCS per month limit.

Am I charged for failed RCS messages?

The amount is taken when you send. Failed and Non-RCS numbers are refunded to your wallet automatically within 48 hours.

What does Non-RCS mean?

The number cannot receive RCS right now. It may be an iPhone or Android phone without RCS turned on, or a number that is not reachable on RCS.

Why does the API say “Invalid or inactive RCS bot”?

The Bot ID is wrong or the bot is not active. Copy it again from RCS Manager > Bots and check the status.

Why can I not send promotional RCS at night?

Promotional bots can send only from 7:00 AM to 10:00 PM. Transactional bots do not have this limit.

Will Fast2SMS resend failed RCS automatically?

No. Failed messages are refunded, not resent. Send them again later or reach those numbers by SMS.