Submit App for Review

Once message delivery between Facebook Page and Yeastar P-Series PBX System is proven to work, you can submit your app for review.

Before you submit

To avoid interruption in App Review submission process, we recommend that you prepare two screencasts in advance, as Meta requires you to upload the recordings for them to test the app.
  • A screencast that demonstrates how you send a message to your Facebook Page and how the message is received and replied on Yeastar P-Series PBX System.

    We provide an example screencast for your reference, as shown below:

    Note: This screencast may be ready if you have recorded one when you test message delivery.
  • A screencast that demonstrates how your app uses a human agent tag to respond to customer messages.

    We provide an example screencast for your reference, as shown below:

Tip: App Review - Best Practices may help improve the quality of your submission and reduce the chances of it being rejected.

Step 1. Complete app settings

  1. Go to the Basic settings page of your Meta app.
    1. Log in to 'Meta for Developers' portal, then go to My Apps from the top menu.

    2. On the App list, click your Meta app.

    3. On the left navigation bar, go to App settings > Basic.
  2. At the top of the page, complete the following settings.

    • Privacy Policy URL: Enter your organization's privacy policy URL.
    • App icon: Upload your organization's icon.
    • Category: Select Messaging.
  3. Scroll down to the bottom of the page, add a website platform to share the PBX URL with Meta.

    1. Click Add platform.
    2. Select the checkbox of Website, then click Next.
    3. In the Site URL field, enter the FQDNof your PBX system.
  4. Click Save changes.

Step 2. Select permissions and features

  1. On the left navigation bar, go to App Review > Permissions and Features.
  2. Search for the required permissions (pages_messaging, Human Agent, and Business Asset User Profile Access) and click the corresponding Request advanced access button to add them to your submission.

  3. Click Continue request.

Step 3. Remove unnecessary permissions

  1. On the left navigation bar, go to Messenger > Messenger API Settings.
  2. In the 3. Complete App Review section, click Request Permission.

  3. Unselect the checkboxes of the following permissions, then click Request Permission.

    You will be redirected to App Review > Requests.

Step 4. Answer data handling questions

  1. On the left navigation bar, go to App Review > Requests.
  2. Scroll down to the Data handling questions section, then click Answer questions about data handling.

  3. Fill in the following information based on your situation, then click Submit.

  4. Complete the following tasks to demonstrate why the pages_messaging permission with advanced access is needed and how the app uses it.
    1. Click How will your app use the advanced access pages_messaging permission?.

    2. Copy and paste the following text in the detailed description box.
      This app is used to integrate Yeastar Phone System with Facebook Messenger. After obtaining the "pages_messaging" permission, agents can manage Page messages within Yeastar Phone System.

    3. In the Test and reproduce the functionality of your integration section, select your Facebook Page, copy and edit the following text based on your situation, then paste in the text field.
      Step 1: Log in to Yeastar Phone System with the following credentials:
Login address:{pbx_fqdn}
Username: {extension_number_or_email_address}
Password: {password}

Step 2: Log in to Facebook with the following credentials and send a message to the Facebook Page:{url_for_facebook_page}
Email or phone: {email_address_or_phone_number}
Password: {password}

Step 3: Receive and reply to the message on Yeastar Phone System.

      In this example, we paste the following text:

      Step 1: Log in to Yeastar Phone System with the following credentials:
Login address:https://yeastardocs.ras.yeastar.com
Username: smith@yeastar.com
Password: rz9nDg3CrO

Step 2: Log in to Facebook with the following credentials and send a message to the Facebook Page: https://www.facebook.com/profile.php?id=61563743597525
Email or phone: yangym@yeastar.com
Password: YpeS345joi

Step 3: Receive and reply to the message on Yeastar Phone System.

    4. Click Upload file to upload the screencast that demonstrates how you send a message to your Facebook Page and how the message is received and replied on Yeastar Phone System.

    5. Select the checkbox to agree that you will comply with the allowed usage, then click Save.

  5. Complete the following tasks to demonstrate why the Business Asset User Profile Access permission with advanced access is needed and how the app uses it.
    1. Click How will your app use the advanced access Business asset user profile access feature?.

    2. Copy and paste the following text in the detailed description box.
      This app is used to integrate Yeastar Phone System with Facebook Messenger. After obtaining the "Business Asset User Profile Access" permission, agents can view the name of Facebook users who send messages to the Page directly within Yeastar Phone System, which enables them to identify different Facebook users and provide better services.

    3. Click Upload file to upload the screencast that you have uploaded for pages_messaging.

    4. Select the checkbox to agree that you will comply with the allowed usage, then click Save.

  6. Complete the following tasks to demonstrate why the Human Agent permission with advanced access is needed and how the app uses it.
    1. Click How will your app use the advanced access Human Agent feature?.

    2. Copy and paste the following text in the detailed description box.
      This app is used to integrate Yeastar Phone System with Facebook Messenger. According to Facebook's rules, user can only use the Message Tag feature to send messages to users outside the 24-hour Standard messaging window. 
After obtaining the "Human Agent" permission, when a customer's inquiry cannot be resolved within the standard messaging window, the agent can use the human_agent tag to continue providing services to the customer.

    3. Click Upload file to upload the screencast that demonstrates how your app uses a human agent tag to respond to customer messages.

    4. Select the checkbox to agree that you will comply with the allowed usage, then click Save.

  7. At the bottom of the page, click Submit for Review and enter password to confirm your operation.

Result

Your submission is queued and you will receive the review result in a few days.

What to do next

After you pass App Review, you need to switch your app to Live mode on 'Meta for Developers' portal, as shown below.