Instagram

Description

The Instagram module sends a direct message (DM) to an Instagram user through Meta’s Graph API. It usually comes after a Trigger Receive Instagram (or an Agent team): it replies to the user who wrote. Ideal for customer support, notifications and conversational assistants on Instagram.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Instagram/Meta credential (accessToken + igId)
recipient	text	No	Destination user ID. Empty = uses data.igSenderId from the trigger
message	textarea	Yes	Message to send (supports {{variable}} variables)

Credentials

The credential must contain:

• accessToken: Meta access token with the instagram_manage_messages permission.
• igId: Instagram Business account ID (IG user id).

1. Create the Meta App with the Instagram/Messenger product and get the access token (instagram_manage_messages) and the IG user id.

2. Create the credential in Floogos (Credentials → New) with { accessToken, igId }.

3. Select the credential in the node’s Instagram credential field.

Replying to the user who wrote

When the message comes from the Trigger Receive Instagram, the trigger leaves the source user in data.igSenderId. Leave the Recipient field empty: the node automatically replies to data.igSenderId. This way you don’t hardcode a user and it works for anyone who writes.

Output

{
  "nextModule": "next_module",
  "data": { "status": 200, "instagram_response": "success", "message_id": "aWdfZG1f..." }
}

API Used

• Send DM: POST https://graph.facebook.com/v21.0/{ig-id}/messages with { recipient: { id }, message: { text } }
• Docs: https://developers.facebook.com/docs/messenger-platform/instagram

Notes

• The recipient is resolved like this: Recipient field → data.igSenderId (from the trigger).
• Instagram only allows replies within Meta’s standard messaging window.
• For the multi-agent conversational assistant, see Multi-agent conversational chat.

Related Nodes

• Trigger Receive Instagram (receive DM)
• Telegram · WhatsApp