Andy Developer Docs

Messenger

Connect a Facebook Page to an Andy Agent so it answers the Page's Messenger conversations, and take over or hand back a conversation.

Outcome

Connect one Facebook Page to an Andy Agent, receive a customer message on Messenger, and verify that the Agent's reply arrives in Messenger. A person can take over any conversation from Meta Business Suite and hand it back to the Agent from Andy.

Messenger is a Pro Max Channel. Andy is turning it on Workspace by Workspace while Meta reviews Andy's app.

Before you connect

Confirm that:

  • The Workspace has Pro Max access and Messenger appears under Connections → Channels.
  • You are an Owner or Admin of the Workspace.
  • On the Facebook Page, your Facebook account has the messaging task and at least one of manage, moderate or create content. Page admins and editors have these.
  • No other Andy Agent answers the Page. A Page belongs to one Agent across Andy.
  • The Agent is enabled and has reviewed Knowledge and instructions for the replies you expect.
  • Instant Reply is off for the Page (see Instant Reply and away messages).

Connect a Page

  1. In the Andy App, select the intended Workspace and Agent.
  2. Open Connections → Channels → Messenger.
  3. Choose Connect Messenger.
  4. Log in with Facebook and approve every permission Meta asks for.
  5. Back in Andy, choose the Page from the list and select Connect this Page. A Page you cannot choose says why: your role on it is not enough, or another Andy Agent already answers it.
  6. Confirm that the Channel shows Connected. Andy shows Connected only after Meta confirms that the Page is subscribed to Andy.

From the CLI, andy channel connect --provider messenger returns the same Andy link. Open it in a browser, sign in to Andy if asked, and continue from step 4.

To disconnect, open the Channel and choose Disconnect. Andy stops answering, removes the Page's access, and keeps the conversations already received.

Verify the message path

  1. From a personal Facebook account that is not an admin of the Page, send a simple message to the Page on Messenger.
  2. In Andy, open Messages for the selected Agent and confirm that the message appears.
  3. Confirm that the Agent's reply appears in the conversation and arrives in Messenger.

What the Agent can answer

  • The 24-hour rule. Meta lets a Page answer a customer within 24 hours of the customer's last message. The Agent answers only inside that window. A message older than 24 hours is stored in Andy but not answered.
  • Text replies. The Agent replies with text. A long reply is sent in parts. When the customer sends an image, a sticker or taps a button, the Agent sees a short description of it and answers the text it has.
  • One reply per burst. When a customer sends several messages quickly, the Agent answers once, after the newest.

Take over and hand back

A person takes over a conversation by replying to the customer in Meta Business Suite, the Page's Inbox, or the Messenger app. Andy sees the reply, saves it in the conversation as the person's, and the Agent stops answering that customer. Andy does not send messages written by a person inside Andy on Messenger.

To give the conversation back, open it in Messages and choose Hand back to Andy. The Agent answers the customer's next message. It does not reply to messages that arrived while a person had the conversation.

If the Agent asks for a person (Human Handoff), it sends its handoff reply and then leaves the conversation to your team in the same way.

Instant Reply and away messages

Turn off Instant Reply for the Page in Meta Business Suite (Inbox → Automations) before you connect. An Instant Reply looks to Andy like a person answering, so the first customer message of each conversation can switch it to a person and the Agent stays quiet. Away messages can do the same. Andy will update this advice once it has confirmed how Meta reports these automatic replies.

Another app answers the Page

If Meta Business Suite or another app is set as the Page's default responder (Conversation Routing), Meta refuses Andy's replies. Andy keeps the Channel connected and shows it as Attention when a customer is still waiting for an answer. In the Page's Conversation Routing settings, make Andy the app that answers, or remove the other app.

Troubleshooting

Messenger does not appear under Channels

Open Config → Usage & plan and confirm the Workspace's Entitlements include Pro Max. If they do, Messenger is not yet turned on for the Workspace.

No Page can be chosen

Each Page in the list says why. Ask a Page admin to give your Facebook account the messaging task and manage, moderate or create content, then connect again. A Page already answered by another Agent must be disconnected there first.

The Channel asks to reconnect

Meta no longer accepts the Page's access, for example after a password change, a removed role, or removing Andy in Facebook settings. Andy emails the Agent's owner. Open the Channel and connect again.

A message appears but the Agent does not reply

Check that the conversation is not with a person (look for Hand back to Andy), that the customer's message is less than 24 hours old, and that Instant Reply is off. If the Channel shows Attention, see Another app answers the Page.

When contacting support, keep the request ID and stable status text. Never send access tokens, passwords, authentication codes, provider credentials, or private customer conversations.

Data deletion

Disconnecting a Page, or removing Andy in your Facebook settings, stops the Channel and keeps the conversations already received.

To have Andy erase the Messenger data it received through your Page connections, remove Andy in your Facebook settings (Settings and privacy → Settings → Business integrations, or Apps and websites) and send the deletion request Facebook offers. Andy erases the Messenger messages and conversation records that came in while you had a Page connected, and Meta shows you a confirmation code. Conversations received while another person had the same Page connected stay with that person. Leads and contacts in your Andy CRM are not deleted.

Current scope

Messenger covers customer messages to a Facebook Page and the Agent's text replies. It does not cover Facebook comments, posting to a Page, sending images, customer names and profile pictures, or messages written by a person inside Andy.

Use Andy App Support for the rest of the authenticated App and Support for the safe evidence template.

On this page