How Instagram DMs work in Yaplet
When someone sends a direct message to your Instagram Business account, it appears in your Yaplet inbox as an ordinary conversation. Agents reply in the same message pane, and the reply is delivered inside the visitor's Instagram thread.
Prerequisites
- An Instagram Business account (not a personal one). If you are on a personal account, convert it to Business or Creator in the Instagram settings.
- The Instagram account must be linked to a Facebook Page in Meta Business Manager. An Instagram-only connection is not supported — the Facebook Page is the bridge.
- Access to Settings → Connections → Meta integration in Yaplet. If you cannot see that entry, ask your organization's owner.
Connect Instagram through the Meta integration
- Go to Settings → Connections → Meta integration.
- Click Add Facebook pages.
- In the Meta dialog, sign in with the Facebook account that manages the Page your Instagram account is linked to.
- Select the Facebook Page or Pages that have an Instagram account attached.
- Grant every permission Yaplet asks for — Instagram DM access is part of the messaging permissions.
- Back in Yaplet, each connected Page appears as a row under Connected business pages, with the columns Page, Channels, Brand and Status. Pages with Instagram attached show an Instagram icon next to the Messenger one in the Channels column.
- On each row, use the Brand dropdown (it shows Select a brand until you choose) to pick the brand the Page belongs to. That brand's chat widget is where the Page's Instagram messages land. The Status reads No brand until a brand is chosen, and then Connected (or Active). With no brand, incoming messages are dropped; if the brand you pick has no chat widget, the row warns you that messages have nowhere to land.
What visitors get in Instagram DMs
Connected accounts pick up the same conveniences visitors know from the chat widget, with nothing to configure:
- Talk to a human, any time: a permanent chat menu offers Talk to a human and Talk to the AI bot, so visitors switch between the AI and your team with a tap. Talk to the AI bot also works when the team member who has the conversation hasn't replied for 5 minutes since the visitor's last message — the conversation then goes back to the AI. If the AI can't answer right now, the visitor is told your team will reply right there. On top of that, once a visitor has sent enough messages in a short window, AI answers carry a tappable Talk to a human quick reply — how many messages that takes is set on Brand → AI agent → Human hand-off.
- Opening questions: the brand's Yaplet agent's first four active conversation starters appear as tappable questions on a new conversation. Starters that start a workflow are left out, and the next ones move up. You write them on Brand → AI agent → Starters. They appear only while Yaplet answers on Instagram — see below.
- Typing and read indicators: visitors see their message marked as seen and a typing indicator while the AI writes — and the inbox shows you when a visitor has read your messages.
- Ratings: the Ask for rating action delivers tappable 1–5 star options.
- Tappable choices: a workflow's dropdown questions become quick-reply buttons instead of a typed numbered list.
- Product cards: AI product recommendations arrive as a swipeable carousel with images, prices and View buttons — and the agent viewing that conversation in the Yaplet inbox sees the same cards.
- Attachments: agent replies deliver every attachment natively — several images, video, audio and files.
These features switch on after the account's first incoming message. The chat menu, opening questions and product cards render in the Instagram mobile apps only — on Instagram web, visitors get plain-text versions instead.
Yaplet answers Instagram conversations only while its Answers on → Instagram switch is on, on Brand → AI agent → General (it is on unless you switch it off). Switch it off and every Instagram message goes straight to your team's queue, your team is notified, and the opening questions disappear from Instagram — Messenger and the website chat are not affected. The chat menu stays, but Talk to the AI bot then has no AI to hand to. The same happens when the brand has no AI agent, or it is switched off. The AI also takes over when a visitor writes into a conversation whose team member is Offline and hasn't written in it for 5 minutes; your team sees a private line saying so. If the AI can't answer, the conversation goes back to your team's queue instead.
Managing the connection
To send a Page's Instagram messages somewhere else, change the brand in the Brand dropdown on its row. The pages that belong to a brand are also listed, read-only, on Brand → Brand settings → Social → Connected pages, which links back here to change them. To add another Page, click Add Facebook business page under the list. To disconnect, open the More actions menu (the three dots) at the end of the Page's row, choose Remove page and confirm — that removes Messenger and Instagram for the Page at the same time, because both ride on the same Meta connection.
Troubleshooting
- No Instagram icon: the Instagram account is probably not properly attached to the Facebook Page. Check Meta Business Manager → Accounts → Instagram accounts.
- Messages not arriving: check the Status is not No brand and that the brand you picked has a chat widget. Also confirm your Meta authorization has not expired — if it has, choose Reconnect in the row's More actions menu and sign in to Facebook again.
- Authorization failed: you need admin access to the Facebook Page, not just to the Instagram account. Ask your Meta Business Manager admin for Page admin rights.
What's next
Facebook Messenger uses the same Meta integration — see Connect Facebook Messenger.