Documentation

Facebook

Facebook

Please note that currently, it can take up to 3 minutes for your live stream to appear on your website.

You must be an admin user of your Facebook page in order to complete the integration of WP Livestream with your page.

Login into Facebook

  1. Login into Facebook as the same user account who also is an admin for the Facebook Page you wish to integrate with.
  2. Navigate to your Facebook Page and copy the ID (number or a username) that is found in the URL.

Enter your Page ID

  1. In your WordPress admin, go to Settings -> WP Livestream
  2. Click on the Facebook Settings tab.
  3. Paste the Page ID you just copied into the Your Facebook Page ID field and click Save Changes.

Create a Facebook App

Next you will need to create a Facebook App. This can seem very technical, but if you follow the steps you should be fine. NOTE: This app will not be officially published and visible by anyone else in the world. We will keep the app in developer mode so that WP Livestream can use the app to authenticate your user and gain access to the Facebook Page so we know when the stream is live or not.

IMPORTANT: Facebook developer apps will get deactivated if there have been no API calls (ie: if there are no live streams) for a 90-day period. If your facebook integration was working and has stopped, please check that your developer app is still active.

  1. Open a new browser tab and go to https://developers.facebook.com/apps/.
  2. Click the green Create App button top right.
  3. A popup will appear asking What do you need your app to do? Select Other
  4. On the next page, select the Business option and click continue.
  5. Give your app an App Name (we suggest “WPLiveStream”) and a Contact Email and click the Create App button.

Settings: Basic

  1. In the left navigation, click Settings -> Basic.
  2. In the App Domains field, enter the domain name of your website(s) where you will be using the WP Livestream plugin.
  3. In the Privacy Policy URL field, enter the full URL of your website’s privacy policy.
    If your website doesn’t have a privacy policy, use your homepage URL.
  4. Click the Save Changes button.
  5. Copy your App ID and App Secret.

Enter your Facebook App ID and Secret

  1. In your WordPress admin, go to Settings -> WP Livestream
  2. Click on the Facebook Settings tab.
  3. Paste the App ID into the Your Facebook App ID field.
  4. Paste the App Secret into the Your Facebook App Secret field.
  5. Click Save Settings.

Configure Facebook Login Settings

  1. Back in the Facebook App settings, in the left navigation, if you do not see Facebook Login for Business under the Products heading, click the Add Product link.
  2. Find the Facebook Business Login app and click the Set Up button.
  3. On left navigation under Products, Click on Facebook Login for Business > Settings.
  4. Ensure that the Login with the JavaScript SDK toggle is set to Yes.
  5. In the Allowed Domains for the JavaScript SDK field, enter the domain name of your website(s) where you will be using the WP Livestream plugin.
  6. Click the Save changes button.

Get your Page Access Token

  1. In your WordPress admin, go to Settings -> WP Livestream
  2. Click on the Facebook Settings tab.
  3. Click the blue Continue with Facebook button which will launch a pop up to connect with Facebook.
  4. Select the Facebook Page that you would like to detect if live.
  5. Click the Next button.
  6. Click the Done button.
  7. Click the Ok button.
  8. The Page Access Token should now be filled in.
  9. Click the Save Settings button.

That was a lot! But now you’re all set. If you are having any issues, please contact support.

Get Support

Troubleshooting Common Issues

My livestream is not getting picked up

Here are a couple of initial things to check if your livestream is not being picked up by WP Livestream:

  1. Are you streaming to Facebook Page or personal profile? Currently, only Pages are supported.
  2. Make sure the FB page you are trying to stream from is “public“.
  3. Make sure the FB page you are trying to stream from is not limited to any age or country (The restriction settings for Country and Age should both be: “Page is visible/shown to everyone“).
  4. Make sure the video being streamed is set to “public“.
  5. Double-check the settings of your app that you created using the above documentation.
Video Unavailable Error

This is usually due to one of two things:

  1. Copyrighted content being used in the stream.
    Most of the time we see this happen due to music being used – were you using any type of music or background track during the stream? If Facebook thinks that your livestream contains music, video, or some other copyrighted element, Facebook will automatically block the video from being embedded. You could mute any copyrighted music for the live stream, but the best thing going forward would be to not utilize any copyrighted material.
  2. Your page or stream is not set to allow to be embedded (see the basic checklist above)
My “Page Access Token” is not showing up after connecting to Facebook app

This happens usually when you have the wrong “Facebook Page Id” and the app is rejecting the authentication. Make sure you login to your Facebook and are on your main Facebook Page (The pages Home page). Look up in the URL and you should see something like “Facebook.com/yourpageIDhere”.