Rapidbott Help Docs
HomeInstagramFacebookLinkedInTwitterWebsite
  • Welcome !
  • start here
    • Getting Support
    • FAQ's
    • WhatsApp Common Questions(FAQ)
    • Pricing Plans
  • getting started guide
    • Introduction
    • Set your goals
    • Building your Chatbot with Rapidbott.
    • Maintain success
  • Rapidbott guide for beginners
    • Introduction
    • What is a Chatbot
    • Channels
    • Benefits & importance
    • Use cases
  • platform
    • Introduction
      • How to start free trial
      • Forgot Password
      • Getting Started Checklist
      • Platform Overview
      • Workspaces & Members
      • Platform default limits
      • Integrations
        • Stripe
        • PayPal
        • Cloudinary
        • Shopify
        • Facebook Business
        • Calendly
        • Slack
        • Google Sheets
        • Data Store
        • Twilio
        • Signalwire
        • Email (SMTP / Gmail)
        • MailChimp
        • VideoSdk
      • Ecommerce
        • Setup Ecommerce
        • Use Ecommerce in the Flow
        • WooCommerce
    • Connect to Channels
    • Agents Group Chat
    • Website Chat
    • My Contents
      • Email Templates
      • Rapidbott Bot Templates
    • WhatsApp Channel
      • Connect with WhatsApp Cloud API
        • Using a phone number already in use with WhatsApp App
        • Step-by-Step Coexistence Onboarding
      • WhatsApp Cloud API Old
      • Connect with Com.bot
      • Connect with Twilio
      • Connect with 360Dialog
      • Connect with 360 Dialog Sandbox
      • How to get your business verified?
      • WABA Policy Enforcement
  • flow builder
    • Flow builder overview
    • Basic Actions
      • Add & Remove Tag
      • Subscribe and Unsubscribe to Bot
      • Set Email Opt-in & Opt-Out
      • Set SMS Opt-in & Opt-Out
      • Steps
      • Question step
      • Variable Operation
      • JSON Operation
      • Send Notification
      • Condition Step
      • Split Step
      • Go To Step
      • Mark Conversation Open/Pending/Spam/Done/Invalid
      • Add note to teammates
      • Delete Bot User
      • Assign to agent/agent group
      • Resume Bot Automation
      • Talk to human/Pause automation
    • Advanced Actions
      • External Request
    • Field variable
    • Sub Flows
      • Sub Flow
      • Workflow
      • Function Flow
  • Artificial Intelligencs
    • OpenAI | ChatGPT
    • DeepSeek AI
    • Google Gemini
    • Claude AI
    • X.AI Integration
    • Coze
    • Dialogflow
  • Mini Apps
    • What is Mini-App?
    • Create Mini-Apps (1.0)
    • Use Mini-Apps
    • Publish Mini-App
    • Mini-App 2.0
      • Overview (mini-app 2.0)
      • Flow Builder (mini-app 2.0)
      • Flows
      • App Fields
      • Auth
      • Action Subflow
      • Triggers
      • One Time Urls
      • Sources
      • Settings
      • Razorpay Demo (Indian Payment Gateway)
  • Users
    • Live Chat
    • Bot Contacts/Users
  • bot automation
    • Keywords
    • Sequences
    • Triggers
    • Comment Keywords
  • contents
    • Custom Fields
    • Tags
    • One Time Notification (Facebook)
    • Personas
    • Menus
    • Customer Feedback (Facebook)
  • tools
    • Error Logs
    • Testers
    • Admins
    • Multi Languages
    • Inbound Webooks
  • Broadcasting
    • Broadcasts
  • developers
    • Rapidbott API
    • Dynamic Content
      • Messages format
      • Buttons
      • Actions format
      • Quick replies
      • Goto
      • Variables
  • Beta Launch
    • Day One
  • Common Error Log Database
    • Common Errors
      • Global Error
      • Facebook Channel Common Errors
      • WhatsApp Channel Common Errors
      • Instagram Channel Common Errors
      • Webchat/Omnichannel Errors
      • SMS Channel Common Errors
      • Voice Channel Common Errors
      • Telegram Channel Common Errors
  • Bot Add-Ons
    • Bot Add-Ons
  • community
    • Website
    • Facebook
    • Instagram
    • Twitter
    • LinkedIn
Powered by GitBook
On this page
  • Error: “Media upload Error”
  • Blocked by Integrity. Integrity requirements not met
  • Error: “Sending payload: 2018062 (#100)”
  • Error: “Message failed to send because there are restrictions on how many messages can be sent from this phone number”
  • Error: “The message could not be sent. You do not have enough funds on your conversation prepaid balance to engage in any paid conversation”
  • Error: “(#200) Permissions error”
  • Error: “Required parameter is missing - Error code 131008”
  • Error: “WhatsApp Message Template not found”
  • Error: “Business account has been locked”
  • Error: “Failed to send message because this user's phone number is part of an experiment”
  • Error: “Failed to send message because this user's phone number is part of an experiment”
  • Error: “Message failed to send because more than 24 hours have passed since the customer last replied to this number”
  • Error: “Business Account and Consumer Account pair rate limit hit”
  • Error: “Error validating access token”
  • Error: “Spam Rate limit hit”
  • Error: “Receiver is incapable of receiving this message”
  • Error: “Message failed to send because more than 24 hours have passed since the customer last replied to this number”
  • Error: “Business Account and Consumer Account pair rate limit hit”
  • Error: “Error validating access token”
  • Error: “Spam Rate limit hit”
  • Error: “Receiver is incapable of receiving this message”
  • Error: “#200 permission error - WhatsApp Cloud API”
  • Error: “Message not sent because outside 24 hours”
  • Error: “Message Undeliverable”
  • Error: “Message undeliverable - Code 131026”
  • Error: “Business eligibility payment issue”
  • Error: “Invalid Parameter #100”
  • Error: “(#132001) Template name does not exist in the translation”
  • Error: “(#131053) Downloading media from weblink failed with https code 401, Unauthorized”

Was this helpful?

  1. Common Error Log Database
  2. Common Errors

WhatsApp Channel Common Errors

PreviousFacebook Channel Common ErrorsNextInstagram Channel Common Errors

Last updated 1 year ago

Was this helpful?

Error: “Media upload Error”

You might see the error message below:

[{"code":131053,"title":"Media upload error","message":"Media upload error","error_data":{"details":"Sticker file could not be processed. Please choose a different file."}}]

The reason is:

This might be the url you are using in the message or template message isn’t publicly available to access.

Also, this can be the file format you are using are not supported by WhatsApp.

Solution:

We were unable to upload the media for one or more reasons, such as an. Refer to the error.error_data.details value for more information about why we were unable to upload the media.

You can check the URL you are using, and make sure the file url starts with https, and ends with the file format at the end of URL, and also this media file should be always publicly accessible.

Blocked by Integrity. Integrity requirements not met

If you see this error message, this message can be triggered if you are trying to use “WhatsApp Flow” feature, you will need to check if your meta business manager is verified or not.

For certain feature like WhatsApp Flow, meta requires verified business manager to get access.

Error: “Sending payload: 2018062 (#100)”

The request included one or more unsupported or misspelled parameters.

You might see error message like this:

Error sending payload: 2018047 (#100)

Failed to upload attachment.

Error sending payload: 2018062 (#100) The URL provided is not on the Messenger Extensions whitelist.

It’s possible that you are using a few user custom field variables, but some of the variables don’t have the value populated.

You can add a conditional check about all the variables you are about to use, and notify the admin if there are any errors.

You can also go to the error logs, and locate the user, and check the value of the variable used in the message, and confirm if all of them have the correct value.

Error: “Message failed to send because there are restrictions on how many messages can be sent from this phone number”

You might see the error message like this:

[{"code":131048,"title":"Message failed to send because there are restrictions on how many messages can be sent from this phone number.This may be because too many previous messages were blocked or flagged as spam.","href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]

This may be because too many previous messages were blocked or flagged as spam It’s because you have sent many messages to other users, but many messages were blocked or flagged as spam.

So meta has placed some limitations on your number. You need to maintain a healthy account quality, otherwise, your account or WABA number might get blocked.

Error: “The message could not be sent. You do not have enough funds on your conversation prepaid balance to engage in any paid conversation”

You might see the error message like this:

The reason is that you don’t have enough funds to your 360dialog account, you will need to purchase more credit from 360dialog. please go to your 360dialog account, insights & billings and add more credits.

Error: “(#200) Permissions error”

If you see this error, the reason is: Permission is either not granted or has been removed.

When you connect your WhatsApp account, you need to select all the permission required.

Error: “Required parameter is missing - Error code 131008”

You might see the error code:

(#131008) Required parameter is missing Parameter of type text is missing text value

Reason:

The request is missing a required parameter.

Solution:

It’s possible that you are using a few user custom field variables, but some of the variables don’t have the value populated.

You can add a conditional check about all the variables you are about to use, and notify the admin if there are any errors.

You can also go to the error logs, and locate the user, and check the value of the variable used in the message, and confirm if all of them have the correct value.

Error: “WhatsApp Message Template not found”

This means that you have used a WhatsApp template message, but we can’t find this template message from your WhatsApp account.

This might be the user changing the message template or deleted it from the WhatsApp business manager and the changes have not been synced back into the Rapidbott Chatbot.

Error: “Business account has been locked”

It looks like your whatsapp business account has been locked by meta. you need to contact meta to get support.

Also, you can go to your WhatsApp manager in the meta business manager for any notifications related to this error.

Error: “Failed to send message because this user's phone number is part of an experiment”

You might see the error message like this:

[{"code":130472,"title":"Failed to send message because this user's phone number is part of an experiment","href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]

Learn more here:

Error: “Failed to send message because this user's phone number is part of an experiment”

You might see the error message like this:

[{"code":130472,"title":"Failed to send message because this user's phone number is part of an experiment","href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]

Error: “Message failed to send because more than 24 hours have passed since the customer last replied to this number”

You might see the error message like this:

[{"code":131047,"title":"Re-engagement message","message":"Re-engagement message","error_data":{"details":"Message failed to send because more than 24 hours have passed since the customer last replied to this number."},"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]

[{"code":470,"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/api\/errors\/","title":"Message failed to send because more than 24 hours have passed since the customer last replied to this number"}]

This is because it has been more than 24 hours since you last received a user initiated message - the session is closed and you can no longer use free-form messages. Please find a way to restrict message sending if there was no incoming message for the given user/phone number within 24h. Alternatively, you can contact the user using a Template Message.

Error: “Business Account and Consumer Account pair rate limit hit”

You might see the error like this:

(#131056) (Business Account, Consumer Account) pair rate limit hit

The reason for this error:

Too many messages sent from the sender phone number to the same recipient phone number in a short period of time.

Solution:

Wait and retry the operation, if you intend to send messages to the same phone number. You can still send messages to a different phone number without waiting

Learn more information here:

Error: “Error validating access token”

You might see the error message like this:

Error validating access token: The session has been invalidated because the user changed their password or Facebook has changed the session for security reasons.

Users who connected to WhatsApp have changed their password on their Facebook account. As a security measure Meta logs out all third-party platforms so reconnect once to establish the connection again will resolve the issue

The solution is to reconnect the channel. Because the user might have changed their password, so the previous token is not valid anymore.

Error: “Spam Rate limit hit”

You might see the error like this:

[{"code":131048,"title":"Spam Rate limit hit","message":"Spam Rate limit hit","error_data":{"details":"Message failed to send because there are restrictions on how many messages can be sent from this phone number.This may be because too many previous messages were blocked or flagged as spam."},"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]

Reason:

Message failed to send because there are restrictions on how many messages can be sent from this phone number. This may be because too many previous messages were blocked or flagged as spam.

Solution:

Error: “Receiver is incapable of receiving this message”

You will usually see the error message like this:

[{"code":131026,"title":"Receiver is incapable of receiving this message","message":"Receiver is incapable of receiving this message","error_data":{"details":"Message Undeliverable."}}]

Possible reasons:

Unable to deliver a message. Reasons can include:

· The recipient phone number is not a WhatsApp phone number.

· Recipient has not accepted our new Terms of Service and Privacy Policy.

· Recipient using an old WhatsApp version; must use the following WhatsApp version or greater:

o Android: 2.21.15.15

o SMBA: 2.21.15.15

o iOS: 2.21.170.4

o SMBI: 2.21.170.4

o KaiOS: 2.2130.10

o Web: 2.2132.6

Solution:

Confirm with the recipient that they agree to be contacted by you over WhatsApp and are using the latest version of WhatsApp.

Learn more information:

Error: “Message failed to send because more than 24 hours have passed since the customer last replied to this number”

You might see the error message like this:

[{"code":131047,"title":"Re-engagement message","message":"Re-engagement message","error_data":{"details":"Message failed to send because more than 24 hours have passed since the customer last replied to this number."},"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]

[{"code":470,"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/api\/errors\/","title":"Message failed to send because more than 24 hours have passed since the customer last replied to this number"}]

This is because it has been more than 24 hours since you last received a user initiated message - the session is closed and you can no longer use free-form messages. Please find a way to restrict message sending if there was no incoming message for the given user/phone number within 24h. Alternatively, you can contact the user using a Template Message.

Error: “Business Account and Consumer Account pair rate limit hit”

You might see the error like this:

(#131056) (Business Account, Consumer Account) pair rate limit hit

The reason for this error:

Too many messages sent from the sender phone number to the same recipient phone number in a short period of time.

Solution:

Wait and retry the operation, if you intend to send messages to the same phone number. You can still send messages to a different phone number without waiting

Learn more information here:

Error: “Error validating access token”

You might see the error message like this:

Error validating access token: The session has been invalidated because the user changed their password or Facebook has changed the session for security reasons.

Users who connected to WhatsApp have changed their password on their Facebook account. As a security measure Meta logs out all third-party platforms so reconnect once to establish the connection again will resolve the issue

The solution is to reconnect the channel. Because the user might have changed their password, so the previous token is not valid anymore.

Error: “Spam Rate limit hit”

You might see the error like this:

[{"code":131048,"title":"Spam Rate limit hit","message":"Spam Rate limit hit","error_data":{"details":"Message failed to send because there are restrictions on how many messages can be sent from this phone number.This may be because too many previous messages were blocked or flagged as spam."},"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]

Reason:

Message failed to send because there are restrictions on how many messages can be sent from this phone number. This may be because too many previous messages were blocked or flagged as spam.

Solution:

Error: “Receiver is incapable of receiving this message”

You will usually see the error message like this:

[{"code":131026,"title":"Receiver is incapable of receiving this message","message":"Receiver is incapable of receiving this message","error_data":{"details":"Message Undeliverable."}}]

Possible reasons:

Unable to deliver a message. Reasons can include:

· The recipient phone number is not a WhatsApp phone number.

· Recipient has not accepted our new Terms of Service and Privacy Policy.

· Recipient using an old WhatsApp version; must use the following WhatsApp version or greater:

o Android: 2.21.15.15

o SMBA: 2.21.15.15

o iOS: 2.21.170.4

o SMBI: 2.21.170.4

o KaiOS: 2.2130.10

o Web: 2.2132.6

Solution:

Confirm with the recipient that they agree to be contacted by you over WhatsApp and are using the latest version of WhatsApp.

Learn more information:

Error: “#200 permission error - WhatsApp Cloud API”

This error is because the user doesn't give enough permission.

Error: “Message not sent because outside 24 hours”

This limit applies to meta channels(Messenger, Instagram, WhatsApp). If the user hasn't engaged with your bot for the past 24 hours.

You can’t reach them directly. For WhatsApp, you will need to send a template message, for Messenger, you will need to send recurring notification or one time notification.

There aren't any good options to reach the Instagram user if they are outside of a 24 hour window.

Error: “Message Undeliverable”

The error code 131026, Message undeliverable

Possible reasons:

Unable to deliver a message. Reasons can include:

· The recipient phone number is not a WhatsApp phone number.

· Recipient has not accepted our new Terms of Service and Privacy Policy.

· Recipient using an old WhatsApp version; must use the following WhatsApp version or greater:

o Android: 2.21.15.15

o SMBA: 2.21.15.15

o iOS: 2.21.170.4

o SMBI: 2.21.170.4

o KaiOS: 2.2130.10

o Web: 2.2132.6

Solution:

Confirm with the recipient that they agree to be contacted by you over WhatsApp and are using the latest version of WhatsApp.

Learn more information:

Error: “Message undeliverable - Code 131026”

Unable to deliver a message. Reasons can include:

· The recipient phone number is not a WhatsApp phone number.

· Recipient has not accepted the new Terms of Service and Privacy Policy.

· Recipient using an old WhatsApp version; must use the following WhatsApp version or greater:

Confirm with the recipient that they agree to be contacted by you over WhatsApp and are using the latest version of WhatsApp.

Error: “Business eligibility payment issue”

The full error can be something looks like this:

[{"code":131042,"title":"Message failed to send because there were one or more errors related to your payment method.","href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]

This error usually happens in Cloud API, WhatsApp channel.

You will need to go to your Facebook business manager, and then WhatsApp manager, and then check if you have any payment issues with your billing. Because meta charge for the WhatApp template message, so you will need to set up the valid credit card in the billing section in your WhatsApp manager.

Error: “Invalid Parameter #100”

You might see the error message like this:

(#100) Unexpected key "index" on param "template['components'][0]['parameters'][0]".

Reason:

The request included one or more unsupported or misspelled parameters.

Solution:

Error: “(#132001) Template name does not exist in the translation”

This error means the template don’t exist The template does not exist in the specified language or the template has not been approved.

Error: “(#131053) Downloading media from weblink failed with https code 401, Unauthorized”

This error arises when a 3rd party storage (Cloudinary, S3 etc) is integrated and a file is shared using a flow without the required permissions resulting in files of certain formats not being delivered to users.

To resolve this, either disconnect your storage integration or enable the settings that allow us to share the files.

Below is an example from cloudinary;

Learn more information here:

The message could not be sent. You do not have enough funds on your conversation prepaid balance to engage in any paid conversation. Please proceed to -> 'Insights & Billing' in order to top up your balance and optionally enable auto-renewal, which will prevent you from running out of funds in the future.

Learn more information here:

Message was not sent as part of an. See.

Message was not sent as part of an. See.

Learn more here:

Check your quality status in the WhatsApp Manager and see the documentation for more information.

Check your quality status in the WhatsApp Manager and see the documentation for more information.

More information here:

See the endpoint's to determine which parameters are supported and how they are spelled.

Ensure when setting the business public key, it is a.

Ensure there is no mismatch between the phone number id you are and a previously stored phone number id.

Make sure your template has been approved and the template name and language locale are correct. Please ensure you follow.

https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes
http://hub.360dialog.com
https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes
experiment
Marketing Message Experiment
experiment
Marketing Message Experiment
https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes
Quality-Based Rate Limits
Quality-Based Rate Limits
https://developers.facebook.com/docs/messenger-platform/policy/policy-overview/
reference
valid 2048-bit RSA public key in PEM format
registering
message template guidelines
unsupported media type
Error Codes - Cloud API - Documentation - Meta for DevelopersMeta for Developers
Error Codes - Cloud API - Documentation - Meta for DevelopersMeta for Developers
Error Codes - Cloud API - Documentation - Meta for DevelopersMeta for Developers
Error Codes - Cloud API - Documentation - Meta for DevelopersMeta for Developers
Error Codes - Cloud API - Documentation - Meta for DevelopersMeta for Developers
Logo
Logo
Logo
Logo
Logo