Troubleshooting issues with the Facebook integration in Enterprise Server 9
This article describes how to resolve various issues when working with or implementing the Enterprise Server Facebook plug-in.
First-step analysis: run the Facebook test on the Health Check page
As a general rule, run the Facebook test on the Health Check page first when encountering any Facebook related issues (such as error messages appearing when importing templates) in Enterprise Server. This will highlight any issues that are related to an incorrect configuration of Enterprise Server which may well be the cause of the problem that you are experiencing.
To run the test, follow these steps:
Step 1. In Enterprise Server, click Advanced in the Maintenance menu or on the Home page. A page with all advanced Maintenance features appears.
Step 2. Click Health Check. The Health Check page appears.
Step 3. At the bottom of the page, click Clear All.
Step 4. Only select the Publish To Facebook test.
Step 5. Click Test.
The test is executed and the result is displayed next to the test. It should display “OK”.
Note: If the test fails, an error is displayed together with instructions for solving it. Follow the instructions and then run the test once more.
Error: "Import Failed: Database Error (S1004)"
Analysis: This error can occur when importing the Facebook Publish Form templates on the Facebook Maintenance page.
Resolution: One possible cause is that no Issues have been created yet for the Facebook Publication Channel. Make sure that at least one Issue exists for this channel (see Creating a Publication Channel for Facebook).
Error: "The registration failed: the user is not authorized to access the application. Please verify the access rights for your Facebook App"
Analysis: This error can occur when trying to register the Publication Channel with the Facebook app (see "Facebook Installation and Configuration" 6. Registering the Publication Channel). It is caused by being logged in to Facebook using an account with insufficient privileges to modify the app.
Resolution: Before clicking the Register button, make sure to be logged in to Facebook in the same browser in which the Enterprise Facebook Maintenance page is opened, using a user account with sufficient privileges.
Error: "Error validating access token"
Analysis: The user password is changed after the Publication Channel was registered with the Facebook app.
Resolution: Unregister and re-register the Publication Channel.
Step 1. Log in to Facebook with a Web browser, using an account that has the administrator role for the app and the created page.
Step 2. Access the Facebook Maintenance page in Enterprise Server.
Step 2a. In Enterprise Server, click Integrations in the Maintenance menu or on the Home page. A page with all integrated services appears.
Step 2b. Click Facebook. The Facebook Maintenance page appears, showing all available Facebook channels.
Note: This step needs to be performed in the same browser in which you logged in to Facebook in step 1. When using a different browser in which a different user is logged in to Facebook, the following error might appear: "The registration failed: the user is not authorized to access the application. Please verify the access rights for your Facebook App.".
Step 3. For the Facebook Channel that needs to be disconnected from its defined Facebook app, click Unregister.
The Publication Channel is unregistered.
Step 4. For the Facebook Channel that needs to be connected to its defined Facebook app, click Register.
Error: "Given URL is not permitted by the application configuration: One or more of the given URLs is not allowed by the App's settings. It must match the Website URL or Canvas URL, or the domain must be a subdomain of one of the App's domains."
Analysis: The Enterprise Server URL that was entered in the settings for the Facebook app does not match the URL of the Enterprise Server installation to which it needs to be connected.
Step 1. Visit https://developers.facebook.com/apps.
Step 2. (Optional, only when multiple apps exist) In the list of apps on the left side of the page, click the name of the app that you want to use for posting to Facebook.
Step 3. Click Edit App. the Basic Settings page appears.
Step 4. In the section Select how your app integrates with Facebook, click Website with Facebook Login. The Site URL field appears.
Step 5. Enter a valid URL, matching your Enterprise Server URL or IP address.
Note: When entering and saving an incorrect URL, you will have to reset the App Secret by clicking "(reset)" next to the App Secret option at the top of the page.