26th Aug 2019

How to create a Facebook app:

Please watch this video first to know how to create a Facebook App. In this video we have shown which permissions are required for ChatPion. We have given the list of the permission just after this video.

You will need below permission to run ChatPion’s core features.

email
public_profile
pages_manage_engagement
pages_read_user_content
pages_manage_posts
read_insights
pages_manage_metadata
pages_read_engagement
pages_show_list
Human Agent

pages_messaging
Business Asset User Profile Access
pages_user_gender
pages_user_locale
pages_user_timezone



How to submit a Facebook app for review:


First, you will need to create a screencast like the below video which will show how Facebook login has been integrated and using the permission ChatPion system. In this screencast video please use the Facebook account of the admin of the App

Demo Screencast:  We strongly recommend creating your own screencast video with your Facebook APP & ChatPion system

(Please use your own logo and name for the ChatPion system)

.



App submit process video: Below video will show how to submit the facebook app for review



Content for each permission to submit

App Verification

https://preview.chatpion.com/home/login_page
Username : reviewer@chatpion.com
Password : 123456

1. User Login to our system with their system username & password.
2. Go to Facebook & Instagram Menu.
3. User then Click the button "Login with Facebook" to import Facebook Account.
4. Our system get the user information, Page List & Access Token.
5. Now Click on the 'Enable Bot Connection' button icon. 6. Then user goes to Social Posting Menu -> Multimedia Post.
7. Then click on 'Create new post' Button.
8. Now enable "Facebook" from top-right corner of the page and you'll see the Facebook accounts pages list.
9. Now click on the "Text,Link,Image,Video" to post Text,Link,Image,Video on Facebook page.
10. User can post text, image, video, link in their pages & schedule for a future date.

pages_manage_engagement :

1. User Login to our system with their system username & password.
2. Go to Facebook & Instagram Menu.
3. User then Click the button "Login with Facebook" to import Facebook Account.
4. Our system get the user information, Page List & Access Token.
5. Now Click on the 'Enable Bot Connection' button icon. 6.Go to Comment growth tools -> Campaigns.
7.Then switch to 'Facebook' account from the top bar of the page.
8. Now Select pages from left side then page’s post list will display on the right column to set the auto reply campaign.
9. Click on Gear icon beside each post.
10. Click on ‘Leave a Comment Now’ link & then put content of your comment & submit. It will comment on that post by page.
11. Also you can set auto reply for comment & private reply for comment from there.


pages_read_user_content:

1. User Login to our system with their system username & password.
2. Go to Facebook & Instagram Menu.
3. User then Click the button "Login with Facebook" to import Facebook Account.
4. Our system get the user information, Page List & Access Token.
5. Now Click on the 'Enable Bot Connection' button icon. 6.Go to Comment growth tools -> Campaigns.
7.Then switch to 'Facebook' account from the top bar of the page.
8. Now Select pages from left side then page’s post list will display on the right column to set the auto reply campaign.
9. Click on Gear icon beside each post.
10. Click on ‘Leave a Comment Now’ link & then put content of your comment & submit. It will comment on that post by page.
11. Also you can set auto reply for comment & private reply for comment from there.


pages_manage_posts :

1. User Login to our system with their system username & password.
2. Go to Facebook & Instagram Menu.
3. User then Click the button "Login with Facebook" to import Facebook Account.
4. Our system get the user information, Page List & Access Token.
5. Now Click on the 'Enable Bot Connection' button icon. 6. Then user goes to Social Posting Menu -> Multimedia Post.
7. Then click on 'Create new post' Button.
8. Now enable "Facebook" from top-right corner of the page and you'll see the Facebook accounts pages list.
9. Now click on the "Text,Link,Image,Video" to post Text,Link,Image,Video on Facebook page.
10. User can post text, image, video, link in their pages & schedule for a future date.


pages_manage_metadata:

1. User Login to our system with their system username & password.
2. Go to Facebook & Instagram Menu.
3. User then Click the button "Login with Facebook" to import Facebook Account.
3. Our system get the user information, Page List & Access Token.
4. Then user can subscribe their pages to Webhook for Messenger BOT & Feed Event by clicking ‘Enable bot connection’ icon.


pages_read_engagement:

1. User Login to our system with their system username & password.
2. Go to Facebook & Instagram Menu.
3. User then Click the button "Login with Facebook" to import Facebook Account.
4. Our system get the user information, Page List & Access Token.
5. Now Click on the 'Enable Bot Connection' button icon. 6.Go to Comment growth tools -> Campaigns.
7.Then switch to 'Facebook' account from the top bar of the page.
8. Now Select pages from left side then page’s post list will display on the right column to set the auto reply campaign.


pages_show_list:

1. User Login to our system with their system username & password.
2. Go to Facebook & Instagram Menu
3. User then Click the button "Login with Facebook" to import Facebook Account.
4. Our system get the user information, Page List & Access Token.



read_insights:

read_insights permission is needed to show Page Messenger Analytics.

1. User Login to our system with their system username & password.
2. Go to Facebook & Instagram Menu.
3. User then Click the button "Login with Facebook" to import Facebook Account.
4. Our system get the user information, Page List & Access Token.
5. Now Click on the 'Enable Bot Connection' button icon. 6. Then from page list, click on the 'Analytics' button to see the messenger insight of that page.
7. Messenger Analytics contains information of Daily unique new conversations, Messaging connections, Daily unique blocked conversations, Daily unique reported conversations, etc.



Human Agent:

This permission is needed to have a human agent respond to user messages using the human_agent tag within 7 days of a user's message.

1. User Login to our system with their system username & password.
2. Go to 'Facebook & Instagram' Menu.
3. User then Click the button "Login with Facebook" to import Facebook Account.
4. Our system get the user information, Page List & Access Token.
5. Now Click on the 'Enable Bot Connection' button icon.
6. Now click on the "Live Agent" menu and switch to Facebook from the top bar of the page.
8. Now you'll get to the "Live Chat" section. From here, you can type messages to other users and see their messages..



Pages_messaging:

Pages_messaging permission is required to create Page Messenger BOT where system will reply to users who send message to page's inbox for customer service or other valuable FAQ information etc.

1. User Login to our system with their system username & password.
2. Go to Facebook & Instagram Menu.
3. Then user Click the button "Login with Facebook" to import Facebook Account.
3. Our system get the user information, Page List & Access Token.
4. Now Click on the 'Enable Bot Connection' button icon.
6. Then go to 'Bot manager' Menu and switch to Facebook from the top bar of the page. Now select your Facebook account and click on "Bot Flow Builder".
7. Now set Bot Clicking by 'Create new flow' Button.



Test and reproduce the functionality of your integration

Hi Facebook Team,

My Messenger BOT works like this way.
If people says "Hi", my BOT will reply "Hi, How can we help you?"
If people says "Info" my BOT will reply "We are a software firm. We develop web application.”
If anyone says "Support" my BOT will reply "Please put your question here, one of my team member will help you".

Thanks for your kind review.
Have a nice day.
Konok

Business Asset User Profile Access:

This feature is necessary for our app to get user first name, last name & profile picture those who send message to our page's Messenger BOT. Bot needs this information to reply with proper personalized way.

1. User send message to page.
2. Our system collect data like First Name, Last Name, Profile Picture to reply them with proper personalized way.
3. Messenger subscriber information like First Name, Last Name, Profile Picture, Gender is stored in Subscriber Manager -> Bot subscribers Menu.

pages_user_genders

We need user gender to show them their interested items correctly depend on the Male or Female & also for using correct pronouns for them.

pages_user_locale

Our app is used by all over the world & we will send different message in a different language for them by identifying their language.

pages_user_timezone

We want to send message to users at a specific time at their own time zone to avoid any interruption like avoid sending push notifications in the middle of the night.


Business Verification : After getting approval of this permission, you will need to assign your business manager account & you will need to verify your business account also if not verified yet. Here you will find the step to submit your business for verification.

Also you may follow some best practice for submitting business verification here

After getting approval of all permissions & business verification, turn Facebook app into Live Mode


After getting all approval you can see like this . This means all permissions are approved





 How to get approval of Instagram Permissions?


6 Comments Login to comment

  • hello All permissions have been approved
    But this has not been approved read_insights

    Not Approved: read_insights
    App Verification feedback
    We were unable to verify one or more of the requested permissions when we logged into your app. As a result, you'll need to resubmit your app and ensure that the requested permission(s) are correctly integrated so that we can complete testing.

    read_insights feedback
    Based on the notes and screencast provided, we weren't able to approve your request for this permission. Please resubmit your request, and ensure that your notes and screencast provide a clear explanation that demonstrates how your app will use the data, as well as who will be using your app (brands, advertisers, general users, etc.).

    thanks

    • xeroneitbd Admin

      4 years ago

      Make sure that you displays Messenger Analytics in your Screencast & tell them that you need for messenger analytics & then resubmit again.

  • hi,
    any idea for anyone who has been using EZInboxer and its addons and still want to use the same application URL by removing the EZInboxer and replace with XeroChat, any instruction we can use or advice without resubmit all approved permissions?

    only need to submit some permission like user_timerzone, user_locale and user_genders. Do we need to create a screencast for it ?

    • xeroneitbd Admin

      4 years ago

      You will need to change all Facebook APP's configuration as below
      App Domain , Site URL , Privacy Policy URL, Terms of Service URL, Valid OAuth redirect URIs as per new installation.

    • JFOC

      4 years ago

      Okay.

      How for the user_gender permissions and other new permissions to request?

    • xeroneitbd Admin

      4 years ago

      You need to submit those permission that not available for your app. Instruction & sample data are already available in this article.


This site requires cookies in order for us to provide proper service to you      Got it