Messenger API support for Instagram Rate Limit

Messenger API support for Instagram (also known as Instagram Messaging API in our Developer Policies) rate limit is based on the number of API calls a user can make within a given period. If this limit is exceeded, API calls initiated by the app or user will fail with an error code 613.

Send API

The send API rate limit for each Instagram Professional account is 5 API calls per second. Developers should attempt to space out API calls when the rate limit is reached.

Conversation API

The conversation API can be used to retrieve conversation history from an Instagram Professional account. The conversation API rate limit for each Instagram Professional account is 2 API calls per second. Developers should attempt to space out API calls when the rate limit is reached.

Webhook

Callback Queue

When an Instagram Professional account send/receive messages, messages are added to a callback queue that will be processed asynchronously. When the backlog of message in your callback queue exceeds 72,000 messages, the Instagram Professional account is considered in heavy load.

Heavy load

When an account is under heavy load, the user will not be able to send new messages. However, existing messages in the callback queue will still be delivered and the new user messages will be queued again once the backlog comes down below 72,000 messages.

User Behavior

To set expectations with the user, we will surface the following banners in the conversation. These banners will stop showing once the backlog comes down below 72,000 messages.

Your Message May Be Delayed: This will be shown when a user’s message is still waiting to be processed.

Your Message Wasn’t Delivered: This will be shown when a user tries to send a message when the account is under heavy load.