NOTE: Before you can submit a Facebook application for review, you must create the "Facebook app", and connect BeezDesk with Facebook - the process is described in another article How to setup Facebook application.
By default, all Facebook apps are granted permissions: email, public_profile and user_friends.
BeezDesk needs some special permissions to read and post to pages and page private messages, therefore you will need to request these permissions and submit your Facebook application for approval.
Start the app submission process by clicking the Start submission button in the Status & Review section.
Next, a popup form will appear where you will choose the actions to approve (see image below).
Select 3 items: manage_pages, publish_pages and read_page_mailboxes (publish_actions is NOT necessary).
These are the permissions required by BeezDesk to fetch from and post to your pages and reply to personal messages on your pages.
Now, click "Add 3 Items" in lower right hand corner.
You will also have to write a short how-to in the "Facebook Login Integration" field for the Facebook reviewer. You can type something like this:
There are 2 types of login to BeezDesk application:
1. customer login: customer can use Login with Facebook to log in and see their tickets
2. admin / agent login: AGENT can post statuses to page and reply to posts and messages to Facebook page. ADMIN can manage Facebook connection and connected pages.
Before the Login with Facebook is enabled, an ADMIN must to connect BeezDesk with Facebook application by entering App ID and App secret. This is done only once in the BeezDesk configuration section.
1. go to <mystore/support/agent> and login with username '[email protected]' and password 'mypassword'
2. click Configuration in left column and then Facebook. There are 2 items in this menu, the Application Setup is where you set App ID and App secret and then go to Pages.
3. in the Pages screen click Connect with facebook
2. click Configuration in left column and then Facebook. There are 2 items in this menu, the Application Setup is where you set App ID and App secret and then go to Pages.
3. in the Pages screen click Connect with facebook
4. in the Page which you want to fetch into BeezDesk, make sure the checkbox 'Status' in the page edit form is checked
BeezDesk Login is then used only for CUSTOMER at <mystore.com/support>
1. click Login in the right column at the top
2. click Login using Facebook blue button in the right center of the page
* NOTE. Add real access credentials here!
This is the video which you MAY or MAY NOT need for the review:
How to connect Facebook with BeezDesk standalone version https://www.youtube.com/watch?v=gV1bssOGock
You also need to click the green Add notes button and write notes for every permission required by the application and describe why BeezDesk needs it and how it uses the permission. We have prepared the text for you so you can just copy and paste it in the appropriate field.
Notes for publish_pages top options: select option Lets people publish content or respond to posts and comments as a Page.
This is the video which is needed for the review:
How to share post on FB page from BeezDesk https://www.youtube.com/watch?v=Sbt7NA-c1qQ
Next: You'll see a question that asks:
"How is your app using publish_pages?" Select: Lets people publish content or respond to posts...
"What platform does your app use publish_pages on?" Switch ON > Web
Notes for publish_pages bottom field:
There are 2 types of login to BeezDesk application:
1. customer login: customer can use Login with Facebook to log in and see their tickets
2. admin / agent login: AGENT can post statuses to page and reply to posts and messages to Facebook page. ADMIN can manage Facebook connection and connected pages.
1. customer login: customer can use Login with Facebook to log in and see their tickets
2. admin / agent login: AGENT can post statuses to page and reply to posts and messages to Facebook page. ADMIN can manage Facebook connection and connected pages.
Only AGENT or ADMIN can post anything to Facebook. This is done at <mystore/support/agent>(login with username [email protected]' and password 'mypassword')
1. click "New" tab in the top section of application screen
2. select Compose Facebook post
3. select from listbox to which page you want to post (shown only if there are more pages)
3. write whatever you want to share
4. click Send
1. click "New" tab in the top section of application screen
2. select Compose Facebook post
3. select from listbox to which page you want to post (shown only if there are more pages)
3. write whatever you want to share
4. click Send
the screen where you compose the post and also what it looks like on Facebook Page is in the attached screenshots.
* NOTE. Add real access credentials here!
Notes for read_page_mailboxes top options: select option Lets people manage the mailboxes of their Pages through the app
This is the video which is needed for the review:
Fetching Facebook page messages with BeezDesk https://www.youtube.com/watch?v=dxwYzS68Rqk
Notes for read_page_mailboxes bottom field:
There are 2 types of login to BeezDesk application:
1. customer login: customer can use Login with Facebook to log in and see their tickets
2. admin / agent login: AGENT can post statuses to page and reply to posts and messages to Facebook page. ADMIN can manage Facebook connection and connected pages.
1. customer login: customer can use Login with Facebook to log in and see their tickets
2. admin / agent login: AGENT can post statuses to page and reply to posts and messages to Facebook page. ADMIN can manage Facebook connection and connected pages.
The BeezDesk application uses periodic cron task to fetch page wall posts and messages. After somebody writes message to Facebook page, it should appear in BeezDesk AGENT interface as a new ticket within a few minutes.
1. somebody sends message to Facebook page
2. BeezDesk cron fetches the message and creates a ticket in AGENT interface from it
3. AGENT logged in to BeezDesk can reply to ticket in BeezDesk application and the reply will be posted to the Facebook private messages communication
2. BeezDesk cron fetches the message and creates a ticket in AGENT interface from it
3. AGENT logged in to BeezDesk can reply to ticket in BeezDesk application and the reply will be posted to the Facebook private messages communication
the screen where you reply to message and also what the reply looks like on Facebook Page is in the attached screenshots.
Notes for manage_pages top options: select option Lets people publish content or respond to posts and comments as a Page.
Notes for manage_pages bottom field: "manage_pages is needed together with publish_actions allows you to read from and post to your pages"
This is the video which is needed for the review:
How to connect Facebook with BeezDesk standalone version https://www.youtube.com/watch?v=gV1bssOGock
Now add some screenshots of how BeezDesk uses the Facebook application. You can use the images attached at the end of this article.
Before you can proceed to the submission of your Facebook app for review, BeezDesk must make at least one call to Facebook API. That means that the BeezDesk to Facebook connection must be set up according to the article How to setup Facebook application first, and then we can finish the submission.
Click the blue "Submit for review” button in the lower right hand corner of the page. You will have to confirm your submission for review by phone (you will receive a text message with a confirmation code), or by adding your credit card information. After you confirm your submission, your application is submitted for review.
That's it. Now just wait until Facebook approves your application. When approved, your BeezDesk app will be able to fetch Facebook comments as tickets, and answer them directly from each ticket.
