Connect Facebook Pages and Instagram business accounts to Aysali Bot. Messenger DMs, Instagram DMs, and page comments appear in the unified inbox; agents reply from the admin panel.

Configure under Settings → Messenger. The help link on Messenger and Instagram settings points here.

Settings overview

Field	Purpose
Secret key	Webhook Verify Token — choose a random string and use the same value in Meta
Get configuration URL	Webhook Callback URL for Meta (points to your bot’s apps/messenger/post.php)
Unsubscribe	Removes webhook subscriptions from all connected pages
Facebook pages (repeater)	Page name, Page ID, Page token, optional Instagram ID, department, tags
DM for Comments	Auto-DM users who comment on a post (leave Post ID empty for all posts)
Disable chatbot	Turn off chatbot for Messenger/Instagram DMs
Disable chatbot for comments	Turn off chatbot for comment threads only

Each Facebook user gets one Messenger conversation and one Instagram conversation in Aysali Bot.

---

Meta app setup (manual)

Aysali Bot uses manual webhook configuration with page access tokens.

1. •

   Create a Meta app

   Sign in at developers.facebook.com. Create an app and select use cases:

   • Engage with customers on Messenger from Meta
   • Manage messaging & content on Instagram
   • Manage everything on your Page (for comments)

   In the Business tab, choose I don’t want to connect a business portfolio yet if prompted.

2. •

   Set verify token and callback URL

   In Settings → Messenger:

   1. Set Secret key (your verify token) and save.
   2. Click Get configuration URL and copy the callback URL.

   In Meta → Use cases → Engage with customers on Messenger → Customize → Messenger API Setup → Configure webhooks:

   • Paste the Callback URL
   • Paste the same Verify Token as Secret key
   • Complete verification
3. •

   Subscribe webhook fields (Messenger)

   Enable: inbox_labels, message_deliveries, message_echoes, message_reactions, message_reads, messages, messaging_account_linking, messaging_handovers, messaging_optins, messaging_policy_enforcement, messaging_postbacks, messaging_referrals, feed

4. •

   Generate page tokens

   Under Generate access tokens, click Connect, select pages, and complete OAuth.

   Under Webhook Subscription, click Add Subscriptions and select: messages, messaging_postbacks, messaging_optins, message_reads, feed, message_echoes.

   Under Tokens, click Generate, copy the Page access token, Page ID, and Page name into Settings → Messenger → Facebook pages. Repeat for each page.

5. •

   Add permissions

   Use cases → Permissions and Features — add:

   • pages_manage_metadata
   • pages_messaging
   • pages_read_engagement
   • pages_show_list
6. •

   Save and test

   Save Aysali Bot settings and send a test message to the Page. It should appear in the admin inbox.

---

Instagram DMs

1. •

   Link Instagram to Facebook Page

   On your Facebook Page: Settings → Instagram (facebook.com/YOUR-PAGE/settings) → Connect account and complete setup. The Instagram account must be a business account (not personal/professional-only).

2. •

   Instagram API setup in Meta app

   Use cases → Manage messaging & content on Instagram → Customize → API setup with Instagram login

   • Use the same Callback URL and Verify Token as Messenger
   • Webhook fields: messages, messaging_postbacks, messaging_seen, messaging_handover, message_reactions, standby, comments
3. •

   Instagram ID

   Open in a browser (replace placeholders):

   https://graph.facebook.com/FACEBOOK-PAGE-ID/?access_token=ACCESS-TOKEN&fields=instagram_business_account

   Copy the Instagram business account ID into Facebook pages → Instagram ID for that page row.

4. •

   Instagram permissions

   Add: instagram_basic, instagram_business_basic, instagram_manage_comments, instagram_manage_messages, instagram_business_manage_messages

5. •

   Publish and review

   Click Publish in the Meta app. Submit App Review for all permissions used. Meta approval is required for production traffic.

Instagram troubleshooting

Issue	Fix
No Instagram DMs	In the Instagram app: Settings → Privacy → Messages → Connected tools → Allow access
Still no DMs	Confirm business account (not personal/pro)
Permission errors	In Meta Business Suite → Users → People → Instagram account → Manage, enable all permissions
Duplicate messages / bot loops	Two bot installations synced to the same Instagram — remove Instagram ID from the other account and click Unsubscribe there

---

Comments

Comments on connected Facebook Pages and Instagram posts sync as conversations. Reply from the admin panel like a normal chat.

DM for Comments

Settings → Messenger → DM for Comments sends an automatic direct message when someone comments for the first time on a post.

• Leave Post ID empty to apply to all posts
• Or pick a specific post ID per rule

Comments and chatbot

• Chatbot and human takeover work on comments
• Disable via Disable chatbot for comments
• Rich messages in comments: images, videos, chips, buttons, and select options are not supported — you see the rendered comment after send

Comment permissions (optional)

Use cases → Manage everything on your Page → Customize, then add:

• pages_read_user_content
• pages_manage_engagement

---

Facebook Messenger notes

• Private Page messages only — public wall posts do not appear in the inbox
• Users appear as leads with Facebook/Instagram name and profile picture
• Disable Facebook automated replies and Facebook AI on the Page — they conflict with Aysali Bot (especially when the chatbot is on)
• One Facebook login per bot tenant — to sync pages from other accounts, the synced Facebook user must be admin on those pages

Multiple Aysali Bot tenants

If you run several bot admin URLs with different Meta assets:

1. In each tenant, complete page connection in Meta.
2. In the Facebook Login modal, temporarily select all pages/Instagram accounts needed across tenants.
3. After sync, remove pages that belong in other tenants from Facebook pages in each admin panel.

---

Limits and channel behavior

Topic	Detail
Message length	Meta limits text — long replies may be truncated (~1000 characters)
Rich messages	Converted to Meta format when possible; buttons/chips/selects max 3 choices; full button UI mainly on Instagram mobile
Queue & routing	Supported — see Queue & routing
Follow-up message	Supported — always sends even if an agent already replied
Offline message	Supported — timetable text is not sent on this channel
Chatbot & AI	Chatbot, human takeover, language detection, spelling correction, multilingual translation, Google search — see OpenAI & AI
Cost	No extra Aysali fee for Meta integration — Meta API usage follows Meta’s terms

Per-page Department and Tags apply when a new conversation starts.

---

Unsubscribe

Unsubscribe removes webhook subscriptions from all Facebook pages. Use it when decommissioning the channel or fixing duplicate-sync issues.

To stop receiving messages from one page only, remove that page’s row from Facebook pages and update subscriptions in the Meta developer dashboard.

---

Related