For the complete documentation index, see llms.txt. This page is also available as Markdown.

Instagram

Overview

The Instagram Integration and Features Component is a modular, multifunctional action node based on Meta API data graph. Its main function is to extend the chatbot's capabilities beyond private messages, allowing direct interaction with the timeline, analysis of metrics, and automations based on the user's social behavior. With it, the flow can validate the contact's relationship status (such as checking whether they follow the page) and interact with public media and brand mentions.

Configuration Parameters

The component's configuration is dynamic and adapts according to the action level chosen by the flow administrator:

  • Credential: Dropdown menu to select the access token or authenticated Instagram Business institutional account that will execute the command in the API.

  • Feature: Defines the macro category of data that will be handled by the component. The options listed in the interface in image_348b2b.png include:

    • Followers: Relationship validations and user base auditing.

    • Posts: Creation, monitoring, or reading of traditional feed posts.

    • Comments: Moderation or automatic replies on public posts.

    • Reels: Publishing or reading data from Reels-format videos.

    • Stories: Posting and monitoring temporary media.

    • Insights: Collection of metrics and engagement performance reports.

    • Mentions: Tracking third-party posts that mention the brand's @.

  • Operation: Contextual field that displays specific actions depending on the selected feature. As exemplified in image_3477eb.png (when the feature is set to Mentions), the operations include:

    • Get posts in which you were mentioned

    • Get data from a comment in which you were mentioned

    • Get data from a post in which you were mentioned

    • Comment on a post in which you were mentioned

    • Reply to a comment in which you were mentioned

Visual Builder

The graphical interface of this component operates under a highly responsive cascading form model:

  • Smart Cascade Layout: The configuration fields appear conditionally. Selecting the item Feature instantly unlocks the menu Operation. If the user chooses a posting operation (such as "Create a Reel"), the form expands to display the required file upload and caption input fields (caption).

  • Conditional Return Mapping: If the selected operation is a query (such as getting data from a post), the node adds output metadata to the flow editor, allowing subsequent blocks to consume the texts or IDs returned by the Graph API.

Special Operators

The logical properties of this component handle transactional audits and public engagement triggers:

  • Engagement Status Validator (Follower Check): When configured on the feature Followers, the engine performs a synchronous call to check whether the user ID that started the chat belongs to the brand's follower list. The component generates two boolean outputs, allowing, for example, discount coupons to be released only to those who actively follow the profile.

  • String Interpolation in Comments and Captions: In blocks focused on replying or creating content, the fields accept the use of double braces {{...}} so that the bot can publish dynamic texts automatically on the feed (ex: "Thanks for the love, {{name}}!").

Practical Examples

The table below shows classic scenarios of how to use this modular component in marketing and automated service strategies:

Selected Feature

Chosen Operation

Variable / Target Payload

Practical Use Case

Followers

Check if user is a follower

Binary conditional output

The customer requests a giveaway item in the chat. The bot checks whether they follow the page; if so, it delivers the link, if not, it asks them to follow first.

Mentions

Reply to a comment in which you were mentioned

Fixed text with dynamic tags

An influencer mentions the brand in a comment on a post. The bot detects the webhook and sends an automatic public thank-you reply.

Reels

Create a Reel post

{{video_url}} + caption

When processing of a promotional video is finished in an external system, the robot flow automatically publishes it to the Instagram feed.

Insights

Get engagement metrics

Variable metrics_data

A time-based flow (Cron) runs the component every night to extract reach metrics and send a summary report to the internal group.

Last updated

Was this helpful?