ig_send_message
Send direct messages to Instagram users via the Meta Graph API. Choose between response, update, or message tag types to manage conversation windows up to 24 hours or extend to 7 days with a HUMAN_AGENT tag for support replies.
Instructions
Send a DM to a user. Requires 'instagram_business_manage_messages' permission. The recipient must have messaged the account first. Messaging window depends on messaging_type: RESPONSE/UPDATE allow replies within 24 hours of the user's last message; MESSAGE_TAG with tag=HUMAN_AGENT extends the window to 7 days (human-sent support replies only — the HUMAN_AGENT feature requires App Review and forbids automated use, per https://developers.facebook.com/docs/features-reference/human-agent). Other tag values are Messenger-oriented; HUMAN_AGENT is the documented reliable choice on Instagram.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Message tag, required when messaging_type=MESSAGE_TAG and forbidden otherwise. HUMAN_AGENT extends the window to 7 days for human-sent support replies and is the only tag with documented Instagram support; the remaining values are Messenger-oriented and may be silently rejected on Instagram. | |
| message | Yes | Message text to send (max 1000 UTF-8 bytes per Meta's Instagram Messaging API) | |
| recipient_id | Yes | Instagram-scoped user ID of the recipient | |
| messaging_type | No | Send API messaging classification. RESPONSE = reply within the 24-hour window (default). UPDATE = proactive update within the 24-hour window. MESSAGE_TAG = send outside the 24-hour window using one of the tag values below (Instagram reliably supports HUMAN_AGENT for the 7-day window). See https://developers.facebook.com/docs/messenger-platform/reference/send-api/. | RESPONSE |