FAQ & Common Errors for Messenger Bots

Facebook Channel Common Errors

Error: ā€œUnsupported post request. Cannot be loaded due to missing permissions, or does not support this operationā€

You might see the error message like this:

Unsupported post request. Object with ID '100343472848953' does not exist, cannot be loaded due to missing permissions, or does not support this operation. Please read the Graph API documentation at https://developers.facebook.com/docs/graph-api

When you connect the channel to our platform. There is a screen that allows you to give the permission we need. please make sure you select all the permission that is asked on that screen.

Please follow this video to connect your Facebook page:

https://www.youtube.com/watch?v=ZwYj1endfJg

Since meta have changed the number of permissions needed, so expect the facebook page permission, you will also need to connect your Facebook business management in the ā€œIntegrationā€ -> E-commerce -> Facebook Business

If you canā€™t see you page when you are redirect back to UChat, check the video below:

The solution is to reconnect your Facebook page, and select the page you want to connect, and give all the permissions our platform needs.

Error: ā€œSending payload: 2534015 (#100) Invalid message dataā€

According to the meta error code, this error is because the type of data you are sending isnā€™t allowed for your message type.

If you are in an omni channel, you should check the supported channel in every message element. There are social icons like below screenshot:

You can learn more information here:
https://developers.facebook.com/docs/messenger-platform/error-codes/

Error: ā€œSending payload: 1545041 (#551) This person isn't available at the momentā€

Either the user generated a lot of errors on our end or The user might block your bot, so the message will not be delivered.

Learn more information:

https://developers.facebook.com/docs/messenger-platform/error-codes/

Error: ā€œYou have been temporarily blocked from performing this actionā€

you might see the error message below:

Error sending payload: (#2022) You have been temporarily blocked from performing this action. It means that Facebook has issued a temporary block on your Facebook account.

we are unable to send to any account that has been blocked by Facebook. We would advise you to check your Facebook business manager or page alert notification center for more information regarding this issue.

Error: ā€œHide comment error: (#200) Users can only edit their own comments published by the same appā€

You see this error if you are using the ā€œhide commentsā€ action in the flow.

You can hide most comments on Posts with the following exceptions:

Ā· comments made by the Page

Ā· comments made by the Page's admins

Ā· comments made by the Page on a User's Post. The Post is owned by the User.

Ā· comments made by any User on another User's Post to the Page. The Post is owned by the User.

Ā· comments made by an Event creator. The Post is owned by the Event creator.

Ā· comments made by a Facebook Group. The Post is owned by the Group.

Ā· comments made by anyone on a review

Learn more information:
https://developers.facebook.com/docs/graph-api/reference/v17.0/comment#hiding

Error: ā€œConnecting different FB pages to different workspaces using 1 FB accountā€

Users have a few issues where they connect one page to a specific workspace and it disconnects when they add another page to a different workspace.

Possible reason for the error:

90% of the time the reason is because the user deselects the FB already connected on the other workspace during the connection process with Facebook.

Possible Solution:

the below video is recorded to be sent to users who have this specific issue and only them since we openly do not promote this procedure

Make sure you select all the pages that are connected to UChat platform, even if it shows the error message, like ā€œxx page is connected to xx workspaceā€, this shouldnā€™t matter.

But you will lose connection for the previous page if you donā€™t select those pages to connect. So always make sure you select all the pages that are connecting to the UChat platform.

Error: ā€œComment reply error: You've already posted this. Posting the same content repeatedly on Facebook isn't allowedā€

you canā€™t post the same content repeatedly.

You can add a randomizer to send different messages or use openAI to dynamically generate personalized content.

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. You will see that error message.

For WhatsApp, you will need to send a template message, for Messenger, you will need to send recurring notification or one time notification.

For the instagram user, you can capture the userā€™s email or phone number, and you can reach out to the user through email or SMS even they are out of 24 hour window.

More information here:

https://developers.facebook.com/docs/messenger-platform/send-messages https://developers.facebook.com/docs/messenger-platform/policy/policy-overview/

The solution is to use a condition like the screenshot below, and make sure you are always reaching the user who interacts with your chatbot for the past 24 hours, and using different methods to reach out to the user who are out of the 24 hour interaction window.

Also you can reach out to the user through email or SMS. You need to make sure the user have opt-in to receive SMS & email messages.

Error: ā€œI canā€™t receive recurring notification request messageā€

The reason for this is, facebook has a rate limit that You can only send one opt-in request per week with the same, specific title to a person. This includes the default value of "Updates and promotions".

So if you are testing the recurring notification request, you might receive the message when itā€™s first time trigger, but it might not trigger in the following test.

Also,

  • Do not send duplicate opt in requests to a person. A duplicate opt in request is defined as having the same title for notifications from a Facebook Page or the same title and image_url for notifications from an Instagram Professional account

  • You can only send in opt in requests during the standard messaging window

  • If a person opts in to marketing messages, this action does not open a standard messaging window

  • You can only see if a person has opted in to receiving marketing messages but not the statuses for pending opt in requests

  • If a person has chosen to stop receiving marketing messages, your notifications will no longer be delivered to that person and you will receive an error

  • A person can block, mute, or report your messaging

  • For marketing messages sent from an Instagram Professional account, generally, up to 10 opt-in requests for different titles can be sent per user over a 7 day period. A sub-limit of up to 5 opt-in requests may be sent to a user in a day. However, you should consider whether users are likely to find each opt-in request relevant and valuable before sending.

These requirements and limitations are subject to change as we are always striving for the best user and business experience. More information:

Marketing Messages - Messenger Platform - Documentation - Meta for Developers

Error: ā€œ1893016 Calls to this API have exceeded the rate limitā€

The reason for this is, facebook has a rate limit that You can only send one opt-in request per week with the same, specific title to a person. This includes the default value of "Updates and promotions".

So if you are testing the recurring notification request, you might receive the message when itā€™s first time trigger, but it might not trigger in the following test.

Also,

  • Do not send duplicate opt in requests to a person. A duplicate opt in request is defined as having the same title for notifications from a Facebook Page or the same title and image_url for notifications from an Instagram Professional account

  • You can only send in opt in requests during the standard messaging window

  • If a person opts in to marketing messages, this action does not open a standard messaging window

  • You can only see if a person has opted in to receiving marketing messages but not the statuses for pending opt in requests

  • If a person has chosen to stop receiving marketing messages, your notifications will no longer be delivered to that person and you will receive an error

  • A person can block, mute, or report your messaging

  • For marketing messages sent from an Instagram Professional account, generally, up to 10 opt-in requests for different titles can be sent per user over a 7 day period. A sub-limit of up to 5 opt-in requests may be sent to a user in a day. However, you should consider whether users are likely to find each opt-in request relevant and valuable before sending.

These requirements and limitations are subject to change as we are always striving for the best user and business experience. More details here:
Marketing Messages - Messenger Platform - Documentation - Meta for Developers