Instagram DM

Send and manage Instagram DMs via Meta Graph API
Join our community

Actions3

Overview

This node enables sending and managing Instagram Direct Messages (DMs) through the Meta Graph API. The primary operation covered here is Send Message, which allows users to send a direct text message to an Instagram user by specifying their Instagram User ID.

Common scenarios where this node is beneficial include:

  • Automating customer support conversations on Instagram.
  • Sending notifications or updates directly to Instagram users.
  • Integrating Instagram messaging into broader marketing or CRM workflows.

For example, a business could use this node to automatically send order status updates to customers who have contacted them via Instagram DM.

Properties

Name Meaning
Recipient ID Instagram User ID of the message recipient.
Message Text The text content of the message to send.
Additional Fields Optional extra parameters; currently supports specifying the messaging product (default: "instagram").

Output

The node outputs JSON data representing the response from the Meta Graph API after attempting to send the message. This typically includes details about the sent message such as message ID and status.

If an error occurs during execution, the output will contain an error field with the error message.

The node does not output binary data.

Dependencies

  • Requires an API authentication token credential for the Meta Graph API associated with an Instagram account.
  • The Instagram account ID must be configured in the credentials to construct the correct API endpoint URL.
  • The node uses the Meta Graph API v19.0 endpoint: https://graph.facebook.com/v19.0/{igAccountId}/messages.

Troubleshooting

  • Common issues:

    • Invalid or missing Instagram User ID (Recipient ID) will cause the API call to fail.
    • Incorrect or expired API authentication token will result in authentication errors.
    • Insufficient permissions on the Instagram account or app may prevent sending messages.

  • Error messages:

    • Errors returned from the Meta Graph API are passed through in the output's error field.
    • If the node is set to continue on failure, it will output the error message per item instead of stopping execution.

  • Resolution tips:

    • Verify that the Instagram User ID is correct and that the recipient can receive messages.
    • Ensure the API authentication token is valid and has the required scopes.
    • Check that the Instagram account linked to the credentials has messaging enabled and proper permissions.

Links and References

Discussion