=== 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 ==
The Facebook Chat Plugin is a free and easy to use tool to connect with customers on your website. With one click, you can add the plugin to your website, enabling customers to message you while browsing your website. Chats started on your website can be continued in the customers' Messenger app, so you never lose connections with your customers. Even those without a Facebook Messenger account can chat with you in guest mode, so you can reach more customers than ever. 

"Having an open line of communication with our customers gives them a sense of confidence from the browsing stage to final checkout," said Ryan Pamplin, CEO of BlendJet. "We noticed that customers who engage with us are three to four times more likely to checkout. With the Chat Plugin allowing us to reach more customers, we’ve tripled our sales since offering it as a customer engagement channel."

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. Facebook Chat Plugin on your website
2. Facebook Chat Plugin on mobile view
3. Starting a conversation via the Chat Plugin
4. Facebook Chat Plugin settings page on first installation
5. Set your desired language, guest mode and customize the greeting text
6. Facebook Chat Plugin 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.
