Publication

The Publication component allows you to connect your Nappai automation workflows directly to your Instagram account. It acts as a bridge between your data management systems and Instagram’s platform, enabling you to automatically share content or gather engagement data.

You can use this component to either publish new posts (images or videos) to your Instagram profile with custom text captions, or retrieve comments associated with specific posts you have made. This helps you manage your social media presence and analyze audience interaction without leaving the Nappai dashboard.

How it Works

This component interacts with the Instagram Basic Display API via the Meta Developers platform. When you configure the component, it authenticates with Instagram using secure credentials you provide.

For Publishing: The component takes a publicly accessible URL of an image or video and a text caption. It then sends this data to Instagram to create a new post on your account.
For Getting Comments: The component uses a specific Post ID to request the list of comments associated with that post from Instagram.

The system handles the technical communication with Instagram’s servers, ensuring that only valid media and authorized actions are processed.

Connection & Credentials

This component requires configuring a credential in the Nappai panel before interacting with the external service:

Go to the Credentials section in your Nappai panel.
Create a new credential of the type Instagram.
Fill in the required fields with your Instagram API details. You can find these by following the Instagram Basic Display API Guide. Ensure you activate the instagram_basic and instagram_manage_comments permissions before generating your keys.
In your workflow, select the saved credential in the Credential input field of this node.

Inputs

Mapping Mode

This component has a special mode called “Mapping Mode”. When you enable this mode using the toggle switch, an additional input called “Mapping Data” is activated, and each input field offers you three different ways to provide data:

Fixed: You type the value directly into the field.
Mapped: You connect the output of another component to use its result as the value.
Javascript: You write Javascript code to dynamically calculate the value.

This flexibility allows you to create more dynamic and connected workflows.

Input Fields

The following fields are available to configure this component. Each field may be visible in different operations:

Operation: Selects the action you want to perform (e.g., Publishing a post or Getting Comments).
Media URL: The public URL of the image or video you wish to publish. The link must be accessible on the public internet. You can obtain these URLs from services like Dropbox.
Type of Media: Specifies whether the media is an Image or a Video. Consult Instagram’s documentation for format requirements.
Publication Text: The caption or text that will appear below your post on Instagram.
Publication Id: The unique ID of an existing post. This is used when you want to retrieve comments from a specific post. If left blank in “Get” operations, it may return comments from all recent publications.

Outputs

Output Data Example (JSON)json

{ “data”: { “id”: “17841400000000000”, “permalink”: “https://www.instagram.com/p/CxXXXXXXXX/”, “media_url”: “https://scontent.cdninstagram.com/v/t51.2885-15/example.jpg”, “timestamp”: “2023-10-27T12:00:00+0000”, “comments”: [ { “id”: “17841400000000001”, “text”: “Great post!”, “username”: “user123” } ] } } Note: The specific structure of the output depends on the operation selected. If publishing, it returns post details. If getting comments, it returns a list of comments.

Connectivity

This component is typically used in social media management or marketing automation workflows.

Incoming Connections: It often receives data from File Storage components (like Dropbox) to get the Media URL, or from Date/Time components to schedule posts.
Outgoing Connections: The output (specifically the Publication Id or Comments Data) is often connected to Database components for archival or Analytics components for reporting. If you are getting comments, you might connect the output to a text processing or sentiment analysis component.

Usage Example

Scenario: Auto-Post a Weekly Update

Get Media: Use a component to download or locate an image URL from your Dropbox account.
Configure Publication: Connect the Media URL output to the Publication component’s Media URL input.
Set Content: Set the Type of Media to Image and enter your weekly update text in Publication Text.
Execute: The component publishes the image to your Instagram feed automatically.

Scenario: Monitor Engagement

Identify Post: Locate the Publication Id of a specific post (perhaps from a previous publish action).
Retrieve Comments: Connect this ID to the Publication component’s Publication Id input.
Set Action: Set Operation to retrieve comments.
Analyze: Connect the output to a component that reads the comments for feedback or customer support analysis.

Important Notes

Public URLs Only: The Media URL must be publicly accessible. Private links that require login or authentication will fail.
Media Format: Ensure your images or videos meet Instagram’s specifications (aspect ratio, file size, etc.).
Permissions: Your Instagram credential must have the correct permissions (instagram_basic and instagram_manage_comments) to perform these actions.

Tips and Best Practices

Test with One Post: When setting up a new workflow, publish one test post to ensure your credential and URL formats are correct.
Use Valid URLs: Ensure your Media URL sources are reliable and fast-loading to prevent timeout errors during publishing.
Handle Errors: If a publish fails, check the error message in the workflow output; it often indicates if the media is invalid or if the token has expired.

Security Considerations

Credential Security: Never share your Instagram API Access Token or Identifier. Treat them like passwords.
Data Privacy: When retrieving comments, be aware of any personal information contained within them, especially if you are sharing or storing this data.