MediaCP Manual
    1. Getting Started
    2. Sales Questions
    3. Frequently Asked Questions
    4. Transcoder System Benchmarks
    5. Start your own streaming platform
    1. Change account currency
    2. Product Licensing
    1. Introduction
    2. Installation & Upgrade
      1. System Requirements
      2. Versions & Releases
      3. Installation
      4. Upgrading
      5. Streaming Servers
        1. Nginx-Rtmp Video Server
        2. Flussonic Media Server
        3. Icecast 2 / Icecast KH
        4. Wowza Streaming Engine
      6. SSL Certificates
    3. Billing Integration
      1. WHMCS Integration Guide
    4. Migrate from other software
      1. Migrate from Centovacast
    5. Backup & Restoration
      1. Backup MediaCP
      2. Restore MediaCP
      3. Transfer to another server
    6. Administration
      1. Custom Web Service Configurations
      2. Reset Admin Password
      3. Port 80 / 443 Proxy
      4. MediaCP System Commands
      5. Change MediaCP domain name
      6. Move media to another hard disk
      7. Secure your server
      8. Troubleshooting Login Errors
      9. Custom Facebook App
    7. Scaling
      1. Scale with Wowza and CloudFront CDN
      2. Nginx-Rtmp with CloudFront CDN
    8. Troubleshooting
      1. Grant access to support team
      2. Troubleshooting Wowza Streaming Engine
      3. FTP Troubleshooting
      4. MySQL Database Troubleshooting
      5. Reporting Troubleshooting
      6. Troubleshooting Liquidsoap AutoDJ
      7. Video Relay Troubleshooting
    1. Introduction
    2. Administrators Dashboard
    3. System Configuration
      1. General
      2. Services
      3. Video Players
      4. Albums
      5. Email
      6. Plugins
      7. Statistics
      8. Backups
      9. Custom HTML
      10. Misc
    4. Customer Accounts
      1. Managing existing Customers
      2. Create a new Customer
      3. Deleting a Customer
      4. Login as another Customer
      5. Send email to Customer
      6. Reset Customer Password
    5. Reseller Accounts
      1. Reseller Plans
      2. Create a Reseller Account
    6. Media Services
      1. Creating a Media Service
      2. Deleting a Media Service
    7. Announcements
      1. Managing Announcements
      2. Creating Announcement
      3. Deleting Announcement
    8. Statistics
    9. Software Health
    10. Software Updates
    11. Email Templates
    12. API
    1. API Documentation
    2. Custom Domain Names
    3. Shoutcast 2 Admin Guide
    4. Wowza and Flussonic on same system
    5. Submit a feature request
    6. Wowza Custom Properties
    1. Shoutcast 2 Live Broadcasting
    2. DJ Priorities
    3. HTML5 Audio Player
    4. Broadcasting with AutoDJ
    5. Shoutcast 2 Premium
    6. Mount Points
    1. Getting started with video streaming
    2. Live Streaming Overview
    3. TV Station Overview
    4. Ondemand Video Streaming
    5. Relay & IP Camera
    6. Connecting your encoder
    7. Managing your media files
    8. Embedding player on your website
    9. Video Transcoding (Adaptive Bitrate Streaming)
    10. Image Logo or Watermark Overlay on Video Stream
    11. nDVR Live Streaming
    12. Shoutcast 2 Stream Publishing
    13. Facebook Live Streaming
    14. Youtube Stream Publishing
    15. Icecast Stream Publishing
    16. Twitch Stream Publishing
    17. Periscope Stream Publishing
Custom Facebook App

Last updated 2 months ago

It is possible to use your own Facebook App with the MediaCP Stream Targets feature. There are several reasons why you might use your own app:

  • To provide a custom brand when publishing content to YouTube
  • To have control over the App & Review Processes

Information

Before creating a Facebook App you should review and complete the following points:

  • To integrate with a custom Facebook App, you must use a MediaCP Unlimited Subscription or Perpetual license.
  • The MediaCP must be configured with HTTPS access
  • You should read through Facebook Developer Policies and the App Review process before starting.
  • Facebook will review your App before it will be usable, they will also require a login and instructions to the software to complete their review.
  • You must include a clearly visible button to access your MediaCP application from your website. It will be checked in the App Review process.
  • You will be required to complete a Facebook Business Verification before your app can be published live.
  • Review Facebook Developer Policies
  • You will be required to provide a valid link to your Privacy Policy which must include the below information:
    • What personal data is collected and why
    • How we use your information
    • Who we share your data with
    • How to request deletion of account data

Create a new App

  1. Begin Create Facebook App
  2. Select app type of None
  3. Add Facebook Login product (not Facebook login for business)
  4. Don’t select any option on the Quickstart page, instead click on Settings from the side menu
  5. Copy the OAuth Redirect URI from MediaCP -> System Config -> Misc and enter in the Valid OAuth Redirect URIs field, then Save changes.
  6. From the side navigation, select Settings -> Basic
  7. Fill in all the requested information, enter your MediaCP hostname for the App domain (i.e., demo.mediacp.net)
  8. Copy the App ID and App Secret and paste into MediaCP -> System Config -> Misc -> Custom Facebook App fields.
  9. From the side navigation, select App Review -> Permissions & Features
  10. Add all items as specified on this page in Required App Permissions & Features section
  11. Submit App for Review to make it live

Required App Permissions & Features

The below is a comprehensive list of the required Permissions and Features that must be enabled on your App to integrate with MediaCP for Stream Target features.

  • Live Video API – Advanced Access
  • Groups API – Advanced Access
  • public_profile – Advanced Access
  • email – Standard Access
  • pages_read_engagement – Advanced Access
  • pages_manage_posts – Advanced Access
  • publish_video – Advanced Access
  • pages_show_list – Advanced Access
  • publish_to_groups – Advanced Access

Provide App Login & Review Steps

We recommend to use the below template as steps for Facebook to use in their App Review. Before sending this, we recommend to:

  1. Create a FB demo account and TV Channel in MediaCP, with a Stream Target created but not logged into Facebook yet.
  2. Update links in the template below
  3. Create a video of the process to upload to facebook
Please review the following procedure to test our app. In this example we use the "Big Buck Bunny" sample video so that you can test the stream. 

1. Navigate to our website at https://www.mywebsite.com
2. Press the Login button at the top of the page
4. Enter login details as below:
Username:fbdemo 
Password: [your-password]

5. The broadcast is already configured with Big Buck Bunny for this demo 
6. Click on Stream Targets or use the direct link at https://yourdomain.com/controller/StreamTargets/46/show/3 
4. Click on Facebook Demo 
5. Press "Login In" button for Facebook and continue 
6. Select Timeline or page target and press "Save" 
7. The application will create a new live broadcast through the API and public the broadcast immediately.

Table of Contents