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 from PSID 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?


25 Comments Login to comment

  • you have video request read_insights premium ?

    now my website can not import account. notify need read_insights premium.

    try demo but can not. please help me video. Thank you.

  • Hi, how are you?
    Now I integrated the app with facebook, however, when I try to test in messenger the bot not response a programared replies, can you help me?

    • xeroneitbd Admin

      2 years ago

      Sorry for late response. Make sure you have enabled four messenger event in webhook settings for that page for first time. Then it should work for admin before getting approval & APP goes live.

      If you still face problem, please feel free to contact our support desk by creating ticket & give access to your system to check the matter for you.

    • jmanuelirra

      2 years ago

      Hi, how are you, now I have enabled four messenger event in webhook settings for my page, my app was approved, however, messenger bot (replies), are not working.
      Please, help me. Thanks.

  • Hello,
    Would be grateful if you can guide us for this. We have get approval for other submission but only these
    Not Approved: publish_pages, read_insights, manage_pages
    All three they send this request: " While your screencast and notes provide a valid use case, we were unable to verify this use case when we logged into your app. Please ensure that your app has correctly integrated the requested permission, and resubmit for review so that we can complete testing."
    Can you please guide us.
    Thanks

    • miraz Team

      2 years ago

      I am not sure what you have done. But if you can submit your facebook app according to our app submission guideline it must approve. Because we are getting app approval regularly. Please recheck you have submitted your app according to our same guidelines. if everything is ok it must approve.

      However before resubmit, just make sure to login into the reviewer account & try to import your admin account there.. Check if it's working or not . If it's worked, resubmit again & instruct the reviewer that it's all working fine in my testing.

  • You have missed out on how to add a test user. I found that if a test user is not added in the development mode, it is impossible to Login with Facebook as the test user.

    • 70percent

      2 years ago

      Of course, but do you give Facebook your Admin account ... I mean the Facebook account login...

  • the account is added to me in the software but not the pages, in developers I get some additional steps that do not appear in the video that you have as a tutorial, sometimes my loging is also dropped, because it tells me that the access token its caduced

  • the App must be Public Mode before to send the App Review? ,

    • xeroneitbd Admin

      2 years ago

      No, Keep app in development mode before app review & also during submitting for review.

  • After getting all above mentioned approvals, when i turn on my app on live mode, all permission which was approved, gone from the "My Permissions and Features"

    Any idea how to resolve this issue?

    • xeroneitbd Admin

      2 years ago

      Because you didn't do business verification & signed supplementary contract . Make sure to submit for business verification , it's should be under Facebook app's Settings->Basic

    • mahmudayaz

      2 years ago

      Okay got it. and one more question. how background sync work? what if two pages at the same time start for background sync. and only one sync is working other one is not? and is there any way to stop the sync?

    • xeroneitbd Admin

      2 years ago

      One will work, other stop & each time cron job takes one page for syncing. As it's for large list of page's & avoid any server error due to large list, so each time it will work for one page & import 500 subscribers each time & gradually import all. No way to stop it right now.

  • I added My Permissions and Features as follows: manage_pages, pages_messaging, publish_pages and read_insights. After getting approval of all permissions & business verification, turn Facebook app into Live Mode, but why when everything has been approved that appears just email and default permission ?

  • 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

      2 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

      2 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

      2 years ago

      Okay.

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

    • xeroneitbd Admin

      2 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