Connect your Instagram Professional account to Tavio for automated DM responses. Instagram messaging uses the same Meta platform as Messenger.
Prerequisites
- An Instagram Professional (Business or Creator) account
- The Instagram account must be connected to a Facebook Page
- A Meta Developer account with an App that has Instagram Messaging enabled
Required Credentials
| page_id | Facebook Page ID linked to your Instagram account |
| access_token | Page Access Token with instagram_manage_messages permission |
| app_secret | Meta App Secret for webhook signature verification |
Webhook URL
Instagram uses the same Meta webhook endpoint as Facebook Messenger:
Meta Webhook (shared with Messenger)
text
https://bankmind.aihookd.site/api/v1/channels/meta/webhookTavio automatically distinguishes between Messenger and Instagram messages based on the object field in the webhook payload (page for Messenger, instagram for Instagram).
Message Flow
- Customer sends a DM to your Instagram account
- Meta forwards the event to your webhook URL
- Tavio verifies the signature using
X-Hub-Signature-256 - The message is routed through the AI pipeline
- Response is sent via the Instagram Send API
Inbound Payload
Instagram webhook payload
json
{
"object": "instagram",
"entry": [{
"id": "INSTAGRAM_PAGE_ID",
"time": 1700000000,
"messaging": [{
"sender": { "id": "IGSID_123" },
"recipient": { "id": "INSTAGRAM_PAGE_ID" },
"timestamp": 1700000000,
"message": {
"mid": "msg_ig_abc123",
"text": "Do you offer mobile banking?"
}
}]
}]
}Instagram-Specific Notes
- Instagram has a 24-hour messaging window. Replies must be sent within 24 hours of the customer's last message.
- Instagram does not support message templates like WhatsApp. All messages are free-form text.
- Story replies and story mentions can also trigger the webhook if subscribed.
- The Instagram account must have messaging enabled in the Professional Dashboard settings.