Custom Facebook App

Note: This feature no longer works with the changes Facebook made on August 1, 2018

This feature allows you to customize the share link and album name of photos posted to Facebook from Sparkbooth. You will need to use Sparkbooth 4.2 or later, and have a Premium license to use this feature

Please note the limitations:

• Only works with Send To Account > Facebook uploader and Send To Guest > Facebook > Upload Then Share (photo uploaded to Facebook)
• Facebook sign in account must be an administrator of the custom app

Creating Facebook App

1. Sign up for a developer account if you do not already have one.
   
2. Next, create a custom Facebook app by going to https://developers.facebook.com/apps and click on "Add a New App"
   
3. In the Create New App dialog, enter your company name in Display Name and Contact Email. Then click the Create App ID button.
   
4. Continue pass the security question to prove you are human, and your app settings will be displayed.
   
5. Under Settings > Basic, enter services.sparkbooth.com for App Domain and the other required fields.
   
6. Press + Add Platform and select Website
   
7. Enter your web site url (i.e. http://www.yourwebsite.com) in the form below, and the copy the redirecting URL into the Site URL under Website section
   
   
8. Press the Save Changes button at the bottom
   
9. Select the Advance tab, check that Native or desktop app and In App Secret embeeded into the client are set to Yes. Press the Save Changes button
   
10. Under Products, click Set Up for Facebook Login
    
11. For Client OAuth Settings, check that Client OAuth Login, Web OAuth Login and Embedded browser OAuth Login are enabled, and enter https://services.sparkbooth.com/static/oauth.html for Valid OAuth redirect URIs. Press Save Changes button.
    
12. Make sure the sign-in account is either entered as an Administrator, Developer, or Tester under the Roles tab.
    
13. On the App Review tab, and make sure the app is not public.
    

Configuring Sparkbooth

Now you can configure Sparkbooth or Sparkbooth Photo Kiosk to use your Facebook app:

1. If you are currently signed into Facebook via Send To Account or Send To Guest in Sparkbooth, sign out and then restart Sparkbooth.
   
2. Copy both the App ID and App Secret values from your Facebook app into Sparkbooth. Open Sparkbooth, and go to Settings > Premium > Custom Facebook App (for Sparkbooth Photo Kiosk go to Settings > Facebook), and paste the App ID and App Secret into the form.
   
3. For Domain URL, enter https://services.sparkbooth.com/static under Basic settings
   
4. You are now ready to test your setup, press the Validate button and sign into your Facebook account, and authorize your Facebook app to post photos.
   
5. If you are successful testing the setup, the Facebook app should now be validated and all Facebook photo uploads from Sparkbooth will be done through your Facebook app. You can now Close the Settings dialog.
   
6. If you are using the Send To Guest Facebook uploader, go to Settings > Send To Guest > enable "Allow guest to send" > enable "Guest's Facebook" > select "Upload Then Share". Click Configure Facebook Upload Account and log into the account to upload photos into. This option will upload the photo to the Facebook account or page, then allow your guests to share the photo on their account. This will not require publish permissions. You will also want to change the share title and description text. Note: the custom Facebook app will not work with Post to Account.
   

Troubleshooting

• If you are having problems with uploading from Send To Account Facebook, make sure the Facebook account you are signing into has been added to the Roles tab for your Facebook App as explained in step 16.
• If you are getting "no publish permissions" error with uploading from Send To Guest Facebook, use the Send to Account then Share option instead.
• For more information about creating Facebook apps, check out the documentation at http://developers.facebook.com