Overview
This node allows users to interact with Instagram Direct Messages (DMs) via the Meta Graph API. Specifically, the "List Conversations" operation retrieves a list of conversations associated with the connected Instagram account. This is useful for scenarios where you want to monitor or manage Instagram DMs programmatically, such as building customer support workflows, automating message handling, or analyzing conversation data.
For example, you could use this node to fetch recent conversations and then trigger follow-up actions based on message content or participants.
Properties
| Name | Meaning |
|---|---|
| Additional Options | Collection of optional parameters to customize the listing of conversations: |
| - Limit | Maximum number of conversations to return (minimum 1, default 50). |
| - Fields | Comma-separated list of fields to include in the response. Default: id,participants,updated_time. |
Output
The output is a JSON array where each item represents a conversation object retrieved from the Instagram Graph API. Each conversation includes fields as specified by the "Fields" input property, typically including:
id: The unique identifier of the conversation.participants: Information about the users involved in the conversation.updated_time: Timestamp of the last update to the conversation.
No binary data is output by this operation.
Dependencies
- Requires an API authentication token credential for the Instagram DM API (Meta Graph API).
- The node uses the Meta Graph API endpoint at
https://graph.facebook.com/v19.0. - The Instagram account ID must be configured in the credentials to form the request URL.
Troubleshooting
Common issues:
- Invalid or expired API authentication token can cause authorization errors.
- Incorrect Instagram account ID in credentials will result in failed requests.
- Requesting too many results without proper pagination may lead to incomplete data or rate limiting.
Error messages:
- Errors returned from the Meta Graph API will be included in the node's output if "Continue On Fail" is enabled.
- Typical error messages might include permission errors or invalid parameter errors.
Resolutions:
- Verify that the API token is valid and has the required permissions.
- Check that the Instagram account ID is correct and linked properly.
- Adjust the "Limit" parameter to a reasonable number to avoid hitting API limits.