=== The Official Facebook Chat Plugin ===
Contributors: facebook
Tags: Facebook, Messenger, Customer Care, Chat, Messaging, Chat Plugin
Requires at least: 3.9
Tested up to: 5.4.2
Stable tag: 1.7
Requires PHP: 5.2.4
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html

The Official Facebook Chat Plugin

== Description ==
With one click, you can add the Facebook Chat Plugin to your website, enabling customers to message you while browsing your website. To see and reply to those messages, simply use the same messaging tools you use for your Facebook messaging, on desktop at facebook.com, Facebook Page Manager App (available on iOS and Android), or by adding your page account to Messenger. It’s free, easy to install and comes with a user interface your customers are already familiar with. 

Key features of the Chat Plugin: 

- No disconnection: Using the plugin creates a long-lived thread between you and your customers in Messenger. Customers can start a chat on your website and carry on in their mobile device with the Messenger app. 
- Chat transcripts are automatically created in the customer’s Messenger account 
- The familiar, modern interface of Messenger builds trust and encourages your customers to engage with you
- You can use the same Inboxes on desktop and mobile that you use to manage your Facebook page messaging 
- You can set up hours of availability, auto replies and FAQ to serve customers when you’re not available


== Installation ==

= Pre-requisites =
__Requires WordPress Version:__ 3.9 or higher
<br />

__Requires PHP Version:__ 5.2.4 or higher
<br />

__Facebook Presence__ <br />
In order to use the Chat Plugin, you will need to have a published Facebook Page. You can find a list of your Facebook Pages by following this [link](https://www.facebook.com/bookmarks/pages).  If you do not have a Facebook Page, you can create one for free [here](https://www.facebook.com/pages/creation/?ref_type=pages_you_admin).
Once you have your Facebook Page ready, you will be asked to login to Facebook on the computer or device you are using to install the plugin. You can then follow the directions below.

= Installing =
To install the Chat Plugin: <br />
1. Log in to your WordPress dashboard, navigate to the Plugins menu and click Add New. <br />
2. In the search field, type 'Facebook Chat Plugin' and click 'Search Plugins'. Select the plugin authored by 'Facebook'. You can install it by simply clicking 'Install Now'.

= Updating =
Following the [Facebook platform and versioning](https://developers.facebook.com/docs/apps/versions), all versions will be supported for 2 years from launch. Updating should be safe and easy.

= Configure plugin for first use =
After navigating to the Chat Plugin settings page, click on 'Setup Customer Chat.' A new window will appear for setting up the plugin and you will be asked to select the Facebook Page you want to use. Next, you will go through the plugin setup with the following steps:
1. You will be asked to select the language and you can customize the greeting message. The default greeting is "Hi! How can we help you?"
2. The next screen allows you to select your response time and chat color. By setting the response time, you can set expectations with your customers on when they will receive a response
3. Next, click on 'Finish' to save these settings and click 'Done' to close this window. The Messenger customer chat plugin should now be installed.
4. You can rerun the setup by clicking 'Edit Customer Chat'. To remove the plugin, you can diactivate the plugin/uninstall it.

<br />
That's it! You're all set. Now all visitors to your WordPress website will see the Messenger customer chat plugin and can message you.

= Support =
If you get stuck, or have any questions, you can ask for help in the [Messenger Platform Developer Community](https://www.facebook.com/groups/messengerplatform).

== Screenshots ==
1. Messenger customer chat on your website
2. Messenger customer chat settings page on first installation
3. Select Facebook Page in setup
4. Set your desired language and customize the greeting text
5. Set your response time and customize your chat color
6. Messenger customer chat settings page after successful setup

== Frequently Asked Questions ==

= What do I need before setting up the Chat Plugin on my website? =
You will need to have a published Facebook Page and be logged into Facebook on your computer or device.

= How does the plugin work? =
The plugin is a snippet of JavaScript code that runs on your WordPress website. There will be a small Messenger chat bubble that loads with your website in the lower right corner. Your customers can click on it at anytime and message you. It works on both mobile and desktop.

= Where can I see all my messages? =
On the desktop, you can see all messages in your Page Inbox. Navigate to your Facebook Page on Facebook and click on 'Inbox' at the top. On mobile, you can download the Facebook Pages Manager app and navigate to Inbox. You can also link your Page account to your Messenger app and access all your messages there. 

= What permissions do I need on a Page to enable the Messenger customer chat feature? =
You need be an administrator of the Page.

= Can I see messaging analytics for my Facebook page? =
On the desktop, go to your Facebook page, and click on Insights on the Navigation bar. On the left hand side, click on Messaging to see your messaging analytics.

= Where can I find support? =
If you get stuck, or have any questions, you can ask for help in the [Messenger Platform Developer Community](https://www.facebook.com/groups/messengerplatform). If you would like to file a bug, please use the Facebook Bug tool found [here](https://developers.facebook.com/support/bugs/).

== Changelog ==

= 1.7 - Aug 5, 2020 =
* Tested up to WordPress 5.4.2
* Added Plugin versioning

= 1.6 - July 27, 2020 =
* Fix security issue

= 1.5 - April 29, 2020 =
* Fix undefined variable error message

= 1.4 - April 13, 2020 =
* Tested up to WordPress 5.3.2
* Simplify installation flow

= 1.3 - June 17, 2019 =
* Tested up to WordPress 5.2.1
* Fixed security issue

= 1.2 - February 28, 2019 =
* Tested up to WordPress 5.1
* Fixed issues with Safari
* Fix: Edge case where multiple SDK loaded on the page resulting with plugin not loading

= 1.1 - October 31, 2018 =
* Updated plugin to use new Facebook JS SDK
* Fix: Error message in code snippet

= 1.0 - September 24, 2018 =
* Plugin released for all users

== Upgrade Notice ==

= 1.7 =
* Added Plugin versioning. Tested up to WordPress 5.4.2

= 1.6 =
* Fix security issue

= 1.5 =
* Fix undefined variable error message

= 1.4 =
* Simplify installation flow

= 1.3 =
* Fix security issue

= 1.2 =
* Handle edge case which resulted in plugin being broken for some users.

= 1.1 =
* Upgraded plugin to use new Facebook JS SDK and minor bug fixes.
