To troubleshoot Instagram in Text, first identify the error type, then follow the matching fix. Most issues come down to a restricted account, a disconnected channel, or a failed media upload. Errors show up in your Inbox as banners, toasts, or messages in the reply box.
What are the Instagram error types in Text?
Instagram errors in Text are alerts that appear when a message can’t be sent or received through your connected Instagram account. They fall into three types: fatal errors block all messaging until fixed, temporary errors fail one message and clear on retry, and context-limited errors depend on the conversation’s state.
Each error has a Meta error code and a subcode, shown below as code/subcode. Some errors have no code because Text detects them itself.
How to handle fatal errors
Fatal errors mean your Instagram account is restricted or disconnected. No one on your team can send or receive Instagram messages until the issue is resolved. Text shows a banner across the app and a message in the reply box. Admins get a button to fix the problem. Agents see that an admin was notified.
Error | Code | What it means | What to do |
|---|---|---|---|
Account restricted | 25 / 2207050 | Instagram has restricted your account. The banner reads “[account name] is restricted. Take action on Instagram.” | Admins: select Go to Instagram, review the account status, and resolve the restriction. Messaging stays unavailable until it’s lifted. |
Token expired or permissions missing | 24 / 2207006, 36001 / 2207005 | The connection to Instagram has expired or lacks required permissions. This often appears as a media error. | Admins: select Reconnect in the banner and reauthorize Instagram. |
Channel disconnected | - | Your Instagram channel is disconnected from Text. The banner reads “[account name] is disconnected. Reconnect to keep sending and receiving messages.” | Admins: select Reconnect, or reconnect the channel from the Instagram settings. |
If you haven’t connected your account yet, see connecting Instagram to Text.
How to handle temporary errors
Temporary errors mean one message failed to send, but the issue is likely to clear on its own. Text shows a toast, and the failed message displays Not sent with a Retry button. If a retry keeps failing, Text adds a system message to the conversation.
Error | Code | What it means | What to do |
|---|---|---|---|
Instagram server error | -1 / 2207001 | Instagram had a problem on its side. The toast reads “Couldn’t send message.” | Select Retry to resend the message. |
Media upload timeout | -2 / 2207003 | The file took too long to upload. The toast reads “File upload took too long.” | Select Retry to upload the file again. |
Media processing failed | -1 / 2207032 | Instagram couldn’t process the file. The toast reads “Couldn’t upload file.” | Select Retry, or upload the file again. |
Media not ready | 9007 / 2207027 | Instagram is still processing the file. The toast reads “Still uploading the file. Try again later.” | Wait a moment, then retry. |
Invalid media | 100 / 2207023, 2207028 | The file type isn’t supported. The toast reads “This file type isn’t supported.” | Upload a supported file instead of retrying the same one. |
How to handle context-limited errors
Context-limited errors mean a message can’t be sent because of the conversation’s state, not because of your account. Retrying won’t help.
Error | Code | What it means | What to do |
|---|---|---|---|
24-hour reply window expired | – | The customer’s last message is more than 24 hours old. Text shows “24-hour reply window closed” and the message box reads “You can no longer reply.” | Wait for the customer to message you again, then reply. |
Frequently asked questions
Only admins can resolve fatal errors. Admins see action buttons in the banner: Go to Instagram to restrict or Reconnect to disconnect.
Instagram access tokens can expire, or permissions can change on Meta’s side. When that happens, Text can no longer send or receive messages and shows a disconnected banner. An admin can restore the connection by selecting Reconnect and reauthorizing Instagram.
Media errors usually mean the file is still processing, took too long to upload, or isn’t a supported type. Wait a moment, then retry the upload. If the file type isn’t supported, send a different file. If every upload fails, the cause may be an expired connection, so ask an admin to reconnect Instagram.
No. Instagram only allows replies within 24 hours of the customer’s last message. After that, the reply box shows a message that the reply window is closed, and Text also adds a system message to the conversation. You can reply again once the customer sends a new message.
What's next?
Now that you know how to troubleshoot Instagram, explore related channel guides and keep your team informed:
How to troubleshoot WhatsApp — Diagnose the same three error types on your WhatsApp numbers.
Connecting Messenger to Text — Add Facebook Messenger so every conversation lands in one inbox.