HomeInstagram API guideInstagram API guide
Instagram API guide

Instagram Messaging API: how business DMs work for apps

A messaging integration is not simply a form that sends a DM. It is an authorized, event-driven system with a customer-initiated conversation, webhook delivery, permission checks, reply eligibility, and an escalation path when a person needs to take over.

Laptop and phone on a small-business desk representing a shared customer message inbox
Illustrative editorial image · Niaje

The basic message lifecycle

An Instagram user starts or opens a conversation with a business professional account. Meta sends supported events to the app’s subscribed webhook callback. The app validates and records the event, shows it in the right team queue, and—if the business is eligible to reply—sends a response through the matching API setup.

The API setup matters. Meta’s Instagram Login messaging guide documents graph.instagram.com and the instagram_business_manage_messages permission. Unified Login and Page-linked Facebook Login have distinct authorization and messaging instructions, so follow the documentation for the specific route you selected.

Customer initiation and reply windows

The standard messaging window depends on the user action that opens it. Meta’s current messaging guide says that for most user actions the standard window lasts 24 hours; when a person sends their first message after clicking a Click-to-Direct ad, it may last up to seven days. These rules are event-specific and should be checked against the current platform documentation before a message is sent.

Meta also describes a Human Agent path for a human support response that needs more time. It can allow a tagged human-agent response within seven days of the user’s message for qualifying support cases. It is not a general extension for automated marketing or a way to bypass the standard window.

Make the inbox safe and useful

A good team inbox tells people why a conversation is in the queue, who owns it, when a reply needs a policy check, and how to hand it back. Separate automated suggestions from messages actually sent, preserve the original customer context, and give an operator a straightforward way to correct a draft or take over.

Build for the awkward cases too: webhook retries, duplicate events, missing media context, expired tokens, a customer asking for a human, and a complaint that should not receive an automated promise. A clear status is better than implying that a reply went out when it did not.

What the messaging API does not permit by default

The API does not make unsolicited outbound DMs a normal workflow. Meta’s guide says a business can message after an Instagram user has sent the professional account a message, within the applicable eligibility window. Group messaging is not supported by the guide. The API’s access is also limited to authorized professional accounts and granted permissions.

Avoid making promises about message delivery, timing, or eligibility from a screenshot or a simulated demo. Validate the exact event, account path, permissions, and current policy before a production system sends a response.

Niaje’s current inbox is a simulation

The Niaje demo includes sample threads, search and filters, local operator replies, and a human-takeover interaction so teams can explore the workflow. These controls change local demo state only. No Instagram message is sent, and no Meta webhook or messaging endpoint is connected.

QUICK ANSWERS

Frequently asked questions

Who can start an Instagram API conversation?

Meta’s Instagram Messaging API guidance describes conversations beginning when the Instagram user sends a message to the professional account through supported Instagram surfaces or interactions.

How long is the standard Instagram messaging window?

Meta currently says the standard window depends on the user action. It is 24 hours for most actions; a first message after a Click-to-Direct ad may allow up to seven days. Check Meta’s live guidance for the specific event.

Can a human agent reply after the standard window?

Meta documents a separate Human Agent path that may allow a qualifying human support response within seven days of the user’s message when properly tagged. It is not for automated promotional messages.

OFFICIAL REFERENCES

Sources and further reading

Platform behavior and review requirements change. Confirm details in Meta’s current documentation before you build or send a message.

Guide updated November 2, 2026. The date does not replace checking the live platform documentation.