Home > Technical Support > Features and functions > How to setup Facebook application

How to setup Facebook application

This setup guide is valid for LiveAgent version 4.14 and higher. 
 

To start with the configuration, you have to get a Facebook developer account so you could use API credentials.

If you are using downloadable license of LiveAgent, your installation must be secured with an SSL certificate. It is a Facebook requirement.
NOTE: If your Facebook account is not verified, you won't be able to create any Facebook app.
NOTE 2: You must have a Facebook page in order to be able to fetch posts and comments from it via the Facebook app you create.
 
Login to your Facebook account and then navigate to http://developers.facebook.com/ and click My Apps > Add a New App in the top menu.
 
After you click "Add a New App" a popup shows up where you are supposed to name your new app. Create your app.
 
 
When created, your are redirected to your new app account - the very fist step is to choose a product. Please choose Facebook Login.
 
 
After that you are asked to select a platform for your app - please choose "Web" type.
 
You are now in Quickstart. Provide your LiveAgent URL, save it and then navigate to Settings> Basic (in the left menu).
 
When in basic settings, fill out the "App Domains" field with the name of the domain of your LiveAgent installation. Only the website from this domain will be able to use your Facebook app. You also have to fill out the "Contact Email" with a valid email address.
Note: if you don't have a domain name (only an IP address) just leave the App Domains blank. If you try to set App Domains to an IP address it will show the following error: "This must be derived from Canvas URL, Secure Canvas URL, Unity Binary URL, Site URL, Mobile Site URL, Page Tab URL or Secure Page Tab URL. Check and correct the following domains: ..."
 
Still in this section you also have to fill out the fields Terms of Service URL, Privacy policy URL and you need to add at least one App Icon.
For Privacy policy URL you can use e.g. "http://www.ladesk.com/privacy-policy-live-agent/" (you can use it as it is valid for all LiveAgent installations), the same for Terms of Service. If you don't have an icon you can use the LiveAgent image attached at the end of this article.
Please notice the App ID and App Secret fields. You will need both App ID and App Secret key later on when configuring the Facebook App inside your LiveAgent.
 
When this is saved, please navigate to 'Facebook Login' product and its Settings. You will have to set 'Valid OAuth redirect URIs' here - insert 2 values "https://<your.domain>/scripts/fb_agent_login.php" and "https://<your.domain>/scripts/fb_visitor_login.php" (and don't forget to replace <your.domain> with your real LiveAgent domain name). If you don't do this Facebook will return an error when you try to connect pages with LiveAgent: "Can't load URL: The domain of this URL isn't included in the app's domains. To be able to load this URL, add all domains and sub-domains of your app to the App Domains field in your app settings."

Now, navigate to App Review section (left menu) and make the app public. Otherwise your chat messages to your customers will be marked as spam by Facebook.

So, right now you are ready to start with the activation of Facebook plugin of your LiveAgent application.
 
In your LiveAgent navigate to Configuration > Facebook and click Enable Facebook
 
 
After refresh of the application the "Enable Facebook" button changes to Connect with Facebook
 
 
After clicking Connect with Facebook you will see a screen like this one:
 
Into the App ID field enter the App ID  and into the App Secret enter the Secret key you found in the "Dashboard" when creating the Facebook app.   Then click  Save.
 
Afterwards at Configuration > Facebook a "Pages" menu item will show up where you can  connect your LiveAgent with all the Facebook pages which you administrate (admin role in Facebook page).
 
 
You will either get a facebook login screen, or if you are already logged in  with a facebook account, then you will see a screen like this one:
 
where you can choose the level of privacy (by default is 'Friends') and where you have to click "Okay"
 
 
After you have set up LiveAgent to connect to Facebook, you can proceed to the last step - submitting Facebook application for review. 
 
By default all Facebook apps are granted permissions: emailpublic_profile and user_friends. LiveAgent needs some special permissions to read and post to pages and page private messages and therefore you will need to request these permissions and submit your application for approval.
 
The process of submitting your Facebook application for review is described step-by-step in another article How to submit Facebook application for review.
 

Ready to try LiveAgent?

It's free for the first 14 days! No credit card required.

Get Started
We work well with others...
Magento Joomla Wordpress Mailchimp
Contact us

support@ladesk.com

+1-800-811-6590 (Toll Free in USA & Canada)

+421 2 33 456 826 (European Union & Worldwide)

Quality Unit, LLC 616 Corporate Way, Suite 2-3278 Valley Cottage, NY 10989

Stay in touch
Blog Google+
© 2004-2015 QualityUnit.com, All rights reserved