Troubleshoot Facebook-TeamRaiser Integrations
If you encounter problems with Facebook Fundraising integration with TeamRaiser, review the following information for possible solutions.
October 2021 update: Facebook updated their required app settings. Check Facebook Fundraising Setup to ensure you have configured all required settings in your Facebook app.
What is the difference between Business Manager and Facebook for Developers?
When wondering about the difference between Business Manager and Facebook for Developers, consider these tips:
In Facebook for Developers, you manage your Facebook app. This is where you become an app admin, grant app access to others, configure settings, and request Fundraiser API access.
In Business Manager, you add your Facebook app.
For business verification, you can request verification from the Business Manager or from within your app. The process is the same. When initiated from the app, you are taken to the Business Manager to complete the request.
As of October 2021, Facebook apps must enable the Login with JavaScript SDK option. Apps must also specify a website domain to allow Facebook Login requests.
Complete steps 3r and 3s in Facebook Fundraising Setup to resolve the error:
If you see an "Invalid Facebook charity page URL" error when entering your Facebook page URL during an app review submission, such as for when you request Fundraiser API access, you may need to change the Categories on your Facebook page.
As a page admin of your organization's Facebook page, open your page.
Select Edit Page Info.
Under Categories, add Nonprofit Organization.
Select Save Changes.
Retry your app submission.
Previously, an App Icon and App Purpose were not required for Facebook apps, but Facebook requires them now.
For your App Purpose, select Yourself or your own business.
Having an App Icon is important, because the icon and app name displays when a constituent uses Facebook Login. A recognized and meaningful App Icon and App Name help people to understand which organization is asking for their data so that they are comfortable.
You can change your App Name at any time without any impact to this integration.
If you try to add a Facebook app to your Facebook Business Manager and see the following, "Unable to Claim" error that states, "There was an unexpected technical issue. Please try again," then you may not be an admin of the app.
Verify that you're an app admin by logging in to Facebook for Developers to view the app. If you can't see the app, then either ask a current app admin to add you as an admin, or ask the app admin to add the app to Business Manager. If neither option is the available, start the Regain Admin Access to your Facebook App process. After Facebook grants you access to the app as an admin, you can add the app to your Business Manager.
If you try to add a Facebook app to your Facebook Business Manager and see an error that says, "App is Invalid," then you may not be an admin of that app.
Verify that you're an app admin by logging in to Facebook for Developers to view the app. If you can't see the app, then either ask a current app admin to add you as an admin, or ask the app admin to add your app to Business Manager. If neither option is available, you need to follow the Regain Admin Access to your Facebook App process. After Facebook grants you access to the app as an admin, you can add the app to your Business Manager.
If you chose to delete your app within Facebook for Developers but need it back for the integration, ask Facebook to restore it.
Tip: This process is different from regaining app access. If you know that your organization has a working app but you can't access it, follow the Regain Admin Access to your Facebook App process.
If you removed/deleted the app yourself, file an appeal to restore the app: https://developers.facebook.com/appeal/
Check your event's end date to ensure it is a reasonable end date. When end dates are set too far in the future, Facebook can throw an error when creating a new Facebook Fundraiser from a Personal Page.
Specify a reasonable end date on your TeamRaiser event as configured in Step 5 of Create A TeamRaiser. You can also specify the exact end date of the Facebook Fundraiser so you can choose when to stop accepting donations. You'll set that in TeamRaiser Setup for Facebook Integration.
Tip: TeamRaiser events accept donations after their end date. However, Facebook Fundraisers don't have this capability.
After setting up integration, if a "URL Blocked" error occurs when you log into a Participant Center and try to connect a Facebook Fundraiser, check the steps below for possible resolution.
In your Facebook app, go to Settings > Advanced.
Check the Require App Secret option which should be off. If it's on, toggle the option to off as shown below.
Save your update and try again.