If you already have a Facebook Developer App then you can skip to the App Review section.
When connecting a Facebook or Instagram account on a white-label domain the Generic application Presence Manager will be used so that users do not know it's myPresences.
To replace this will your own application name, logo, Authorised Domain and Privacy Policy you can create your own Facebook application. The process is detailed below.
Costs
Setting up a Facebook developer account and creating your own Facebook Application is free.
Facebook Developer Account
Login to your Facebook Developer Account at:
https://developers.facebook.com/
If you don't have a developer account then create one:
https://developers.facebook.com/docs/development/register
You should be logged into Facebook using the business email address you use to manage your business on Facebook.
Don't use a personal email address.
If you don't have a business presence on facebook at all create one first. And then you can setup your Facebook Business Page as well to have a presence on Facebook.
Adding a Facebook App
- login to your facebook account.
- go to Facebook for developers
- Click on My Apps.
- Click the green Create App button in the top right corner.
- Choose Business as the App Type.
- Click Next.
- Enter the name for the application, your users will see this name when connecting.
- Enter your email , app purpose (clients) and choose your Business Account.
- Click Create App.
Your app is created, next add products.
Facebook Login
This allows your application to be used to connect or authorize access to users accounts.
- Add facebook login and click setup.
- Choose web.
- Enter details about your app.
- In Site Url enter your white label domain or subdomain.
Basic Settings
- Go to Basic under Settings on the left menu.
- Add your App Domain.
- Set a logo.
- Complete all other fields.
- Click Save changes.
Facebook Login Settings
In Valid Oauth Redirect URls enter:
https://<your whitelabel domain>/auth/complete/14/
https://<your whitelabel domain>/auth/complete/296/
This allows the ability to connect Facebook and Instagram accounts.
Make sure Enforce HTTPS is on.
Click Save Changes.
Adding Credentials to myPresences
myPresences requires your APP ID and APP Secret.
These can be found at the top of the Basic App Settings page for your app which is available under App Settings and then Basic on the navigation menu.
Click the Show button to see your App Secret and copy it to be used to setup myPresences.
You can add Facebook to your white lablel services in Account -> White Label -> Services.
App Permissions and Features
Your app will receive some basic permissions but you will need to apply for the following if you require the functionality listed beside each permission. You will also need to upgrade standard access to advanced where required.
Facebook Permissions
| Permission |
Notes
|
Level Required
|
|---|---|---|
| pages_show_list |
Allows your app to access the list of Pages a person manages.
This is needed during Authentication to choose the page they are connecting.
|
Advanced.
Defaults to Standard you will need to request access to advanced.
|
|
public_profile
|
Allows apps to read the Default Public Profile Fields on the User node.
This permission is automatically granted to all apps with advanced access.
|
Advanced.
|
| read_insights |
Allows your app to read the Insights data for Pages, apps and web domains the person owns.
This is needed to generate Analytics for your users Facebook page.
|
Advanced.
Defaults to Standard you will need to request access to advanced.
|
| pages_read_engagement |
Allows your app to read content (posts, photos, videos, events) posted by the Page, read followers data (including name, PSID), and profile picture, and read metadata and other insights about the Page.
Need to manage your users Facebook page.
|
Advanced.
Defaults to Standard you will need to request access to advanced.
|
|
pages_manage_posts
|
Allows your app to create, edit and delete your Page posts.
Needed if you want your users to post to Facebook from the Posts page.
|
Advanced.
Defaults to Standard you will need to request access to advanced.
|
|
pages_read_user_content
|
Allows your app to read user generated content on the Page, such as posts, comments, and ratings by users or other Pages, and to delete user comments on Page posts.
Needed to manage user comments on your users Facebook pages.
|
Advanced.
Defaults to Standard you will need to request access to advanced.
|
Instagram Permissions
| Permissions |
Notes
|
Level Required
|
|---|---|---|
| instagram_basic |
Allows your app to read an Instagram account profile's info and media.
This is needed for monitoring users instagram profiles.
|
Advanced.
Defaults to Standard you will need to request access to advanced.
|
| instagram_content_publish |
Allows your app to create organic feed photo and video posts on behalf of a business user.
This is needed if you want your users to post to instagram from the Posts page.
|
Advanced.
Defaults to Standard you will need to request access to advanced.
|
|
instagram_manage_insights
|
Allows your app to get access to insights for the Instagram account linked to a Facebook Page. Your app can also discover and read the profile info and media of other business profiles.
This is needed to generate Analytics for your users Instagram accounts. |
Advanced.
Defaults to Standard you will need to request access to advanced.
|
For each of the permissions you need access to you can start a review.
App Review
Test API Requests
Before you can do an App Review to request advanced access for an API facebook requires a test API request to be performed. Once a test API call has been made for a permission the button to request advanced access will become available within 24 hours.
To create a test api call:
- Go to the Graph API Explorer.
- Choose your application if not selected.
- Click Generate Access Token.
- Go through the flow and provide access to your application.
Run test api calls like below and then wait for the buttons to request review to be available. It says up to 24 hours but should be enabled in a few minutes.
To create a test call for:
pages_show_list
use the path me/accounts and then click submit.
See these articles
Comments
0 comments
Please sign in to leave a comment.