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 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, 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 - navigate to Dashboard please. Click 'Choose platform' to set the type of application you want to create - choose "Website" type.
In the following screen of the configuration wizard, you can click "Skip Quick Start" in the top right hand corner. All the settings can be set in the configuration later.
After you click "Skip Quick Start" the Dashboard page of your App shows up. In this Dashboard notice the  App ID and Secret fields. Next to the Secret field you will have to click the 'Show' button so that you receive the Secret key. 
You will need both App ID and Secret key later on when configuring the Facebook App inside LiveAgent.
Now, choose the "Settings" menu and fill in 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 the 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 that Settings screen (Basic tab) click "Add Platform" and choose "Website".
Then, you will see the Settings screen (Basic tab) again and the "Website" section in it. Now, in that "Website" section you have to set the "Site URL". The Site URL must be a URL address leading to your installation of LiveAgent, including the protocol (http:// or https://). The value should look like "http://some-example-domain.com/".
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). If you don't have an icon you can use the LiveAgent image attached at the end of this article.
In newer Facebook apps, a product "Facebook login" is automatically added under section "Products". If you have this product, you must also set Use Strict Mode for Redirect URIs  to "Off" and  Valid OAuth redirect URIs to value "https://<your.domain>/scripts/fb_agent_login.php". If you don't do this, when you try to connect pages with LiveAgent, Facebook will return error "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), you need to make it public or your messages in chat to your customers will be marked by Facebook as a spam.
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


+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