# Facebook Messenger Quick Start

<figure><img src="/files/UarJJH6xbGjS6kfpC96k" alt="" width="188"><figcaption></figcaption></figure>

### Introduction <a href="#introduction" id="introduction"></a>

This Quick Start Guide will walk you through the basics of setting up a Facebook Messenger Channel with IS-Messenger. You will learn how to create a Facebook Business Page, connect your Facebook Business page to IS-Messenger and how to configure your Facebook Messenger Channel to meet your business needs.

### Getting a Facebook Business Page <a href="#getting_a_facebook_business_page" id="getting_a_facebook_business_page"></a>

A Facebook Business Page is a way for businesses, brands, and organizations to reach their customers. The following section describes the requirements to get one.

### **Requirements**

Before you create a Facebook Business Page, you will need the following:

* **A personal Facebook Profile** - To get a [personal Facebook profile, follow these steps](https://www.facebook.com/help/mobile-basic/188157731232424).

{% hint style="info" %}
Your personal **Facebook profile** and your **Facebook Business** page are considered two separate accounts by Facebook.
{% endhint %}

* **Category** - The type of business you are creating. You can select up to three categories that best describe your business, brand, or organization. [Learn more about the best practices to choose a category for your Page or profile on Facebook.](https://www.facebook.com/business/help/376650512904346?id=939256796236247)

Now, to create your **Facebook Business Page** you can either:

* Go to the [Facebook for Business website](https://www.facebook.com/business/pages/set-up) and click the **Create a Page** button.
* Follow the steps in [Create a Facebook Page for your Business](https://www.facebook.com/business/help/473994396650734?id=939256796236247) to create your business page.

### **Meta Business Verification**

Verifying your business gives you access to certain Meta technologies and developer features. [Learn more about Facebook Business Verification here](/ismessenger/messaging-channels/facebook-messenger.md).

### Connect Facebook Messenger Channel on IS-Messenger <a href="#connect_facebook_messenger_channel_on_respond_io" id="connect_facebook_messenger_channel_on_respond_io"></a>

Watch the video below for a step-by-step guide on How to Connect Messenger to IS-Messenger

Follow the steps below to connect IS-Messenger with Facebook Messenger.

**Step 1:** Click **Settings** > **Channels**

**Step 2:** Click **Add Channel** > **Facebook** **Messenger > Connect**

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696388007819/kapture-2023-09-25-at-15-37-26-2.gif" alt=""><figcaption></figcaption></figure>

**Step 3:** Click **Connect With Facebook**

**Step 4:** Sign in with a Facebook Account

{% hint style="info" %}
You must sign in using a Facebook account with admin access.
{% endhint %}

**Step 5:** Select the Facebook Business Page

**Step 6:** Click **Done** to complete the setup

{% hint style="info" %}
Once you have completed the setup, any messages sent to your Facebook Page will now be received in your IS-Messenger Workspace.
{% endhint %}

{% hint style="warning" %}
To chat with your customers over Facebook Messenger, you will need to create a Facebook Page and you must be the page admin.
{% endhint %}

### Channel Configuration <a href="#channel_configuration" id="channel_configuration"></a>

The Facebook Messenger Configuration page allows you to change your Channel's name and also gives you a click-to-chat link.

**Step 1:** Click **Settings** > **Channels**

**Step 2:** Locate your Facebook Messenger Channel > **Manage**

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696388898859/kapture-2023-10-04-at-11-07-25.gif" alt=""><figcaption></figcaption></figure>

**Step 3:** In the **Facebook Messenger Configuration page** you will see the following:

* **Channel Name** - The Channel Name can be changed and is used internally to identify the Channel.
* **Chat Link** - A click-to-chat link is a shortened URL that directs customers to start or continue a conversation with your Facebook account. The customer is redirected to a new or existing thread, based on whether the user had previously messaged your Facebook account. You can also generate a QR code to share the chat link to your Contacts.

{% hint style="info" %}
[Learn how to create your Messenger click to chat link](https://developers.facebook.com/docs/messenger-platform/discovery/m-me-links/).
{% endhint %}

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696386887138/image.png" alt=""><figcaption></figcaption></figure>

### FAQ and Troubleshooting <a href="#faq_and_troubleshooting" id="faq_and_troubleshooting"></a>

This section is to be used as a guide for issues you encounter with your Facebook Messenger Channel.

**Why am I unable to connect Facebook Messenger Channel to IS-Messenger?**

If you are having problems connecting Facebook Messenger Channel to IS-Messenger, here’s what you can do:

1. Check that your Facebook Page is **published**.

{% hint style="info" %}
[Learn more about how to publish your Facebook Page here.](https://www.facebook.com/help/642707099175171/?helpref=search\&query=publish\&search_session_id=cd2d87b22f7f3d5c84dafe372a27f790\&sr=0)
{% endhint %}

2. Confirm that IS-Messenger is set as the **Primary Receiver for the Handover Protocol** on your Facebook Page.

If IS-Messenger is not set to the Primary Receiver, follow the steps below to configure it:

Navigate to your Facebook Page and click **Settings** > **Advanced Messaging** > **Connected Apps** and click **Configure.** In the **App Settings** window, set IS-Messenger as the **Primary Receiver**.

{% hint style="info" %}
When the **Primary Receiver** function is turned on, the selected app will be the main handler for all incoming messages. The **Handover Protocol** feature enables two or more apps to communicate. [Learn more about the Handover Protocol here.](https://developers.facebook.com/docs/messenger-platform/handover-protocol/)
{% endhint %}

3. Confirm that the correct Facebook Page is selected in the **Edit Settings** option on the IS-Messenger platform.

**Why don't my messages appear in IS-Messenger even though my Facebook Messenger Channel is connected?**

There are two potential reasons for this:

1. Permissions on the IS-Messenger platform can become outdated when your Facebook password is changed.

Here’s how you can resolve this issue:

**Step 1:** Click **Settings** > **Channels**

**Step 2:** Navigate to your **Facebook** **Messenger Channel**

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696387282358/image.png" alt=""><figcaption></figcaption></figure>

**Step 3**: Click **Manage** > **Troubleshoot** > **Refresh Permission**

{% hint style="info" %}
Once you have refreshed the Facebook permissions, you will also see a notification that the Channel token has been updated.
{% endhint %}

2. Your Facebook Page is connected to multiple apps. You will need to confirm that the **Primary Receiver for Handover Protocol** is set to IS-Messenger

**Step 1:** Navigate to your Facebook Page

**Step 2:** Click **Settings** > **New Pages experience** > **Advanced Messaging** > **App Settings** > **Configure**

**Step 3:** In the **App Settings** window, set **IS-Messenger** as the **Primary Receiver**

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696387364468/image.png" alt=""><figcaption></figcaption></figure>

**I received the error message&#x20;*****Channel already exists*****&#x20;when trying to connect the Facebook Messenger Channel to my workspace**

Your Channel is already connected in a different workspace. You’ll need to check where the Channel is connected and disconnect the Channel in order to switch workspace connections.

Here are some things you will need to provide when you contact us:

* Your **Facebook Page ID**

{% hint style="info" %}
Check this document to learn how to [find your Facebook Page ID.](https://www.facebook.com/help/1503421039731588)
{% endhint %}

* The **admin email address** used to log in to the organization. This will help us find where the existing Channel is connected. You can then use this information to log in and disconnect the Channel.

Another cause for this issue is when the trial subscription for the Organization where the Channel is connected has ended. For instances like this, you can request a trial extension from us, which can help you disconnect the Channel on the trial account.

**Why aren't all Facebook pages listed when connecting to a Channel?**

This could be because the permissions for the Facebook account have changed and the correct Facebook Page is not selected. You will need to refresh the Facebook permissions and select the correct Facebook page.

**Step 1:** Click **Settings** > **Channels** > **Facebook Messenger** > **Manage** > **Troubleshoot** > **Refresh Permission**

**Step 2:** Click **Edit Settings** > select the desired Facebook Page

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696387526357/image.png" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696387547260/image.png" alt="" width="375"><figcaption></figcaption></figure>

### **Facebook page dropdown shows&#x20;*****No Data***

{% hint style="info" %}
This can happen when an ad blocker is being used.
{% endhint %}

**Try the following methods:**

* Use another browser such as Chrome, Firefox, Safari, or Opera and reconnect with Facebook.
* Turn off the ad-blocker temporarily.

### **Blank screen when Connect to Facebook is clicked**

This can happen when connecting through a private network where Facebook is blocked.

**Try the following methods:**

* Use a different browser such as Chrome, Firefox, Safari, or Opera and reconnect with Facebook.
* Check your internet or wi-fi connection and reconnect to Facebook.

### **Why isn’t my Facebook page being shown?**

This issue can happen if the user rejects Facebook Permissions after clicking Connect With Facebook, or if the Facebook configuration does not initialize correctly.

**Step 1:** Navigate to the [Business Integrations](https://www.facebook.com/settings?tab=business_tools\&ref=settings) page on Facebook and verify that IS-Messenger appears in the **Active** tab

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696387682767/image.png" alt="" width="375"><figcaption></figcaption></figure>

Step 3: Click **Save** and try to connect

{% hint style="warning" %}
If the page is still not available, proceed to the next step.
{% endhint %}

**Step 4:** From the IS-Messenger dashboard, click **Settings** > **Channels**

**Step 5:** Locate your Facebook Messenger Channel > **Manage** > **Troubleshoot**

**Step 6:** Click **Refresh Permission** to refresh Facebook permissions

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696388957000/kapture-2023-09-25-at-15-44-14.gif" alt=""><figcaption></figcaption></figure>

**Step 7**: Click **Edit settings** and select the page with issues. Verify that the page is selected and all permissions are enabled for that page

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696387769195/image.png" alt="" width="375"><figcaption></figcaption></figure>

**Step 8**: Verify that all permissions are enabled for that page

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696387803234/image.png" alt="" width="375"><figcaption></figcaption></figure>

**Step 9**: Click **Done** and retry sending a test message

### **Why aren’t my Facebook messages arriving?**

This might happen because your Facebook Messenger Channel permissions are outdated. One common cause is when you change your Facebook password. In that case, you'll need to update the permissions on the IS-Messenger platform and refresh the page.

**Step 1:** Click **Settings** > **Channels**

**Step 2:** Locate your Facebook Messenger Channel > **Manage** > **Troubleshoot**

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/9n7a21mlc1/1696388994347/kapture-2023-09-25-at-15-44-14.gif" alt=""><figcaption></figcaption></figure>

**Step 3:** Click **Refresh Permission**

**Step 4:** Send a test message to the Facebook Messenger Channel and check that the message has been successfully sent.

**Why can’t I receive read receipts?**

Your Facebook permissions may be outdated and will need to be refreshed.

Refer to the troubleshooting solution for [Messages Are Not Arriving](/ismessenger/messaging-channels/facebook-messenger/facebook-messenger-quick-start.md) on how to refresh the Facebook page permission.

**Why can’t I send out messages?**

This can happen if IS-Messenger is not the Primary Receiver.

### **Try the following methods:**

1. Make sure that IS-Messenger is the **Primary Receiver** of your Facebook page. Follow the steps below to configure your **Primary Receiver**:\
   Navigate to your Facebook Page and click **Settings** > **New Pages experience** > **Advanced messaging** > **App Settings** > **Configure.** In the **App Settings** window set IS-Messenger as the **Primary Receiver**
2. Refresh the Channel permissions. Follow the steps below to **refresh permissions**:\
   Click **Settings** > **Channels** > navigate to your **Facebook** Channel > click **Troubleshoot** > **Refresh Permission**

**Why did I receive the error&#x20;*****The action is invalid since it’s not the thread owner*****&#x20;when trying to send an outbound message from the IS-Messenger Messages module?**

Because the Channel restricts automated messages, this error can happen when messages aren't sent by a person or human agent after the 24-hour messaging window. This occurs if the [Human\_Agent tag](https://developers.facebook.com/docs/features-reference/human-agent/) is turned on in IS-Messenger. Messages like echoes, workflow messages, and bot-generated ones are examples of non-human agent responses.

**Why did I encounter the error "*****Human agent tag is unavailable for this page/app*****" in Facebook business integration?**

This error typically indicates a routing conflict in outbound messages due to multiple messaging apps connected to your Facebook account. To resolve this, ensure that IS-Messenger is set as the default routing app in your Facebook advanced messaging for conversation routing.

**Why did I encounter the error&#x20;*****"Error validating access token: The session has been invalidated because the user changed their password or Facebook has changed the session for security reasons"*****&#x20;when trying to send a message?**

This error will occur if you have recently updates your Facebook credentials, it may disrupt the Channel connection on our platform, leading to errors when sending messages.

To resolve this issue, you need to refresh the channel permissions on our platform using your updated Facebook credentials. This process requires an Admin role. By refreshing the permissions, you'll re-establish the connection with the new credentials, ensuring that your outbound messages are sent successfully without encountering errors.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.is-messenger.com/ismessenger/messaging-channels/facebook-messenger/facebook-messenger-quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.