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.

Find your Page ID

  1. Click the “Click here to find your page id” link in the WP Livestream Facebook settings to use the tool right from your dashboard to find your Facebook ID.
  2. Copy the ID.

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

  1. Open a new browser tab and go to https://developers.facebook.com/apps/.
  2. Click the Add a New App or the My Apps -> Create App button.
  3. A popup will appear asking What do you need your app to do? Select Manage Business Integrations.
  4. Click Continue.
  5. Enter the Display Name and Contact Email for your App and click the Create App ID button.

Basic Facebook App Configuration

  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 under the Products heading, click the Add Product link.
  2. Find the Facebook Login app and click the Set Up button.
  3. Click on Facebook Login > 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 Continue with Facebook button.
  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.


Troubleshooting Common Issues

Basic checklist

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)