Troubleshoot Messenger

How to troubleshoot Messenger: common issues and fixes

The Messenger integration connects your Facebook pages to Text, so you can manage customer conversations from one inbox. If something stops working, Messenger errors usually fall into one of three categories: fatal, temporary, or context-limited. Each type points to a different issue and requires a different solution.

How to handle fatal errors

 

Fatal errors mean the Messenger integration has been disconnected or blocked. Messaging won’t resume until the issue is resolved on Meta’s end or the integration is reconnected. While a fatal error is active, all Facebook messaging is paused for both sending and receiving.

Error

Code

What it means

What to do

App access removed

200 (2534041)

Meta has revoked Text’s access to your Facebook page – typically after a permissions change or app review.

Reconnect your Facebook page from Text settings. The account admin will see a prompt to reconnect.

Business blocked by Meta

100 (2534029)

Your Meta Business Portfolio has been blocked due to a policy violation.

Go to Meta Business Suite to review and resolve the policy issue. Messaging will remain unavailable until Meta lifts the block.

Account security checkpoint

190 (490)

Meta has temporarily blocked the connected account due to a security check — usually triggered by suspicious login activity.

Check the Facebook account associated with the integration and complete any security verification Meta requires. Once cleared, reconnect from Text settings.

Missing page permissions

190 (2069032)

The integration is missing one or more required permissions to manage the page. This can happen after a permissions change on the Facebook side.

Reconnect your Facebook page from Text settings to reauthorize the required permissions.

Access token expired

190

The access token used to authenticate the connection has expired — this can happen after a password change or prolonged inactivity.

Reconnect Messenger from Text settings to generate a fresh token.

Corrupted token

190 (460)

The access token is invalid or has been corrupted, preventing authentication with Meta’s API.

Reconnect Messenger from Text settings. If the error persists after reconnecting, contact support.

How to handle temporary errors

 

Temporary errors mean a message failed to send right now, but the issue is likely to resolve on its own. You’ll see a Not sent indicator on the failed message — click Retry or Try again to resend.

Error

Code

What it means

What to do

Unknown or transient error

1–99

An unspecified, short-lived error on Meta’s side prevented delivery. The cause isn’t always identifiable.

Retry the message. If the issue affects multiple conversations, check Meta’s platform status.

Meta rate limit

613 (2534040)

Your page has hit Meta’s messaging limit – the platform caps how many messages a page can send within a given period.

Wait a few minutes, then try again. If you regularly hit this limit, review Meta’s messaging rate limits for your page type.

 

Temporary errors are the only error type where retrying makes sense. For fatal or context-limited errors, retrying the message won’t help — those require a different fix.

 

How to handle context-limited errors

 

Context-limited errors mean a message can’t be sent because of the state of the conversation. During a context-limited error, the reply box is disabled until the conversation state changes.

Error

Code

What it means

What to do

Reply window expired

Facebook Messenger limits business replies to a 24-hour window after the customer’s last message. That window has closed.

Wait for the customer to message you again — this reopens the window.

Customer blocked your page

The recipient has blocked your Facebook page. Meta prevents any messages from reaching them.

No action is available. You can archive the conversation to keep your inbox tidy, but messaging this contact isn’t possible unless they unblock your page.

 

When a context-limited error occurs, the message box is disabled — you won’t be able to type a reply until the conversation state changes. Unlike temporary errors, these don’t clear on their own.