Facebook App Integration

You now have the ability to create a Facebook App that allows you to sell tickets directly from your organization's Facebook page. The following steps are how to create this app. PLEASE NOTE: You must be an administrator for both Agile Ticketing Solutions and for your organization's Facebook page in order to create the app.

1. Log into Administration on the Agile Software.
2. First, you will need to go to the Security folder and create a Facebook Web User. We recommend that you use your organization's name and then Facebook User (i.e. agilefacebookuser). Make sure that associated Sales Channel is set to Web. For more instructions on how to create a username and password, see Creating Usernames For Your Staff.
   
3. Next, open the yellow Web folder.
4. Click on the Entry Point icon.                                                                                        
5. In the Entry Point Group, right-click and select New, then Internet Group.
6. Enter the name of the Entry Point Group. We recommend that you put your organization's name in front of Facebook App for the name of the entry point group (i.e. Agile Film Facebook App).
7. Point the Sales User to the Web User name you created in Step 2.
8. Choose Online Web Sales from the Sales Terminal drop-down.
9. In the Skin drop down, choose Facebook App.
10. Right-click in the Buyer Types field, and select the Web Sales Channel that is available to your organization (This is generally Web-Standard, but some organization may have different web sales channel types).
11. Click OK to save your Entry Point Group.
12. Next, you will create the Entry Point that will become part of the App. Most organization's use the Agile List/Calendar view to appear on their page. See Create An Agile List: Event/Show Entry Point for more instructions if necessary.
13. Click Copy to Clipboard to copy the URL and then paste it into Notepad. You will need to use this URL later on the Facebook Developers page.
14. Make sure that you are logged in to Facebook. Once logged in, go to the following URL, https://developers.facebook.com .
15. At the top right of the page, you will need to click on “My Apps” and then select Create App.  
16. Enter the name of your new app.
17. Enter your contact email address.
18. Click on Create App ID. 
    
19. Answer the Security Check when prompted.
20. Once you have gone through the Security Check, hover on Settings and select Basic.
21. You will now be on the App Dashboard. Copy the App ID and the App Secret and paste to the Notepad (by pasting to your notepad, it will give you quick access as you will need these both later in the set up process).
22. Select the Category that closest represents your organization (i.e. Entertainment, Business, etc.).
23. For App Domain, use the domain that your Entry Point is located. This is likely something like prod3.agileticketing.net. For Namespace, you can use just about anything as long as it is not already used and fits the naming scheme. For more info, see https://developers.facebook.com/blog/post/542/     
24. For the Privacy Policy URL: if your organization already has a page on their website for your privacy policy, you may paste that URL here. Otherwise, you can use the one from Agile Ticketing's homepage: https://www.agiletix.com/privacy-statement
25. At the bottom of the settings page, click on Add Platform.  
26. Click on Page Tab.   
    
27. In the Secure Page Tab URL area, paste the link that you copied from Agile. Make sure to add https:// in front of the URL for the Secure Page Tab URL. You do not have to enter the URL into the Page Tab Edit URL.
28. Under Page Tab Name, enter the title for the button you wish to appear on the Facebook page (i.e. Buy Tickets, Membership, etc.).
29. Save Changes.
30. Scroll back to the top of the page and click the "Off" slider beside Status:
31. You will see the below Pop-up. Click confirm.
32. This will make the app available for public use.
33. Click Save Changes.
34. In Agile, log in to Administration and click the Settings folder.                                              
35. Select the System Control icon.        
36. On the General Tab, paste the App ID/API Key and the App Secret from Notepad.
37. Go back to the Web organization folder. Right-click on the Facebook Entry Point Group and checkmark Show Facebook Login.
38. Next, you’ll need to navigate to the following URL. https://www.facebook.com/dialog/pagetab?app_id=xxxxx&display=popup&next=yyyyy In this URL, where you see xxxxx, enter the appID, and where you see yyyyy you will add the Entry Point from Agile (not the App Secret). TIP: Paste the URL above in Notepad first, then add the Entry Point and the AppID where needed.             
39. Open the link in your browser, and attach the app to the appropriate Facebook page. This URL will only work if you are an administrator of your Facebook Page and an administrator in Agile.    
40. The App should appear on the left-hand side of your Facebook page.
41. Select the appropriate page from the Facebook Pages drop-down.        
42. Once you have selected the Facebook Page, click on Add Page Tab at the bottom right of the page to save the app.
43. On the Facebook page, click on select Settings, then Templates and Tabs. This will allow you to move your App up higher in priority to display in the Facebook menu on your page.
44. Simply drag the app to change the priority order. You can also select to Add or Remove Tabs.

*Note if you are still having problems viewing your events on the Facebook App. Go into your App management page. Make sure that your App is live at the top of the screen.