Instagram Block
The Instagram Block connects your Instagram Professional account to Convotic, enabling DM sync, comment tracking, and story reply handling. All conversations are unified in your Convotic inbox and can trigger automated Workflows.
Features
| Feature | Description |
|---|---|
| DM sync | All Instagram Direct Messages are synced to Convotic in real time. Agents can reply from the Convotic inbox. |
| Comment tracking | Public comments on your posts are captured and can trigger Workflows (e.g., auto-reply via DM). |
| Story replies | When a user replies to your Instagram Story, the reply appears in Convotic and can trigger automations. |
| Media support | Send and receive images, videos, and voice messages through the Convotic inbox. |
Connection flow
The Instagram Block uses OAuth 2.0 via the Facebook/Meta platform.
- Go to Settings > Blocks > Instagram and click Connect.
- You will be redirected to Facebook Login.
- Select the Facebook Page linked to your Instagram Professional account.
- Grant the requested permissions (pages_messaging, instagram_basic, instagram_manage_messages, instagram_manage_comments).
- Convotic stores the access token and begins syncing.
警告
Instagram messaging is only available for Instagram Professional accounts (Business or Creator) that are linked to a Facebook Page.
Webhook events
The Instagram Block produces the following webhook events:
| Event | Description |
|---|---|
messaging.message.received | A new DM was received from a user. |
messaging.message.sent | A message was sent to a user (from Convotic or the native app). |
messaging.message.read | A message was read by the recipient. |
messaging.comment.created | A new comment was posted on one of your posts. |
messaging.story_reply.received | A user replied to your Instagram Story. |
messaging.reaction.added | A user reacted to a message. |
Workflow triggers
The following triggers are available when the Instagram Block is connected:
| Trigger | Description |
|---|---|
new_message | Fires when any new DM is received. |
keyword | Fires when an incoming message matches a specified keyword or phrase. |
story_reply | Fires when a user replies to your Story. |
comment_keyword | Fires when a comment on your post contains a specified keyword. |
new_conversation | Fires when a DM is received from a user for the first time. |
Example: auto-reply to a Story mention
- Create a new Workflow with the story_reply trigger.
- Add a Send Message node with a thank-you message.
- Optionally add a Tag Contact node to label users who engage with your Stories.
- Publish the Workflow.
Permissions required
| Permission | Why it is needed |
|---|---|
pages_messaging | Send and receive DMs |
instagram_basic | Read profile information |
instagram_manage_messages | Access Instagram DM conversations |
instagram_manage_comments | Read and respond to comments |
Limitations
- Instagram enforces a 24-hour messaging window. You can only send messages to users who have messaged you within the last 24 hours, unless you use a pre-approved message tag.
- Comment replies via the API are limited to text only.
- Group conversations are not supported by the Instagram API.