Sign In Using Facebook
Facebook® Sign-In Integrations let your customers connect with Facebook to quickly sign up for an account or log in to the Client Area.
Configuring Sign-In with Facebook
To configure sign-in using Facebook on your WHMCS installation:
1. Create a Facebook App.
To use sign-in integrations with Facebook, you must create a Facebook app. You can do this using your existing Facebook account. Users will only see the app name that you define. They will not see anything relating to the account that you use to create the app.
To create your app in Facebook:
- Visit the Facebook developer portal.
- Log in to your Facebook account.
- Click Create App.
- Select Consumer as the app type.
- Click Continue.
- Enter a display name for App Display Name. This is the name that users see when authorizing your app. We recommend using your company name here.
- Enter your email address for App Contact Email. The system uses this email address for important communication about your app.
- Click Create App.
- Under Facebook Login, click Set Up.
- Select Web as your platform.
- Enter the full URL to the root domain of your website.
- Click Save.
- Click Continue.
2. Configure the App Permissions.
To configure the required permissions for your Facebook App:
- From the App Review menu, select Permissions and Features.
- Locate the
public_profile
option and click Get Advanced Access. - Agree to the request and click Confirm.
3. Retrieve the App Credentials.
To retrieve the Facebook App credentials from your Facebook account:
- Go to the Facebook developer portal.
- From Settings, select Basic.
- Click Show to view the App ID and Secret.
4. Configure the App in WHMCS.
To enable sign-in integrations with the Facebook app in your WHMCS installation:
- Log in to the WHMCS Admin Area.
- Go to Configuration () > System Settings > Sign-In Integrations.
- Select Activate under Facebook.
- Enter your credentials for Facebook App ID and Facebook App Secret.
- Click Save & Activate.
WHMCS will attempt to validate and test the details that you have entered. If the credentials are valid and successfully authenticate with the Facebook API, the system will save them.
Common Errors
You may see the following common errors while setting up sign-in integrations with Facebook:
Error Message | Description | Recommended Solution |
---|---|---|
Invalid details not saved. Please verify your details and try again. | You may receive the above error message when attempting to configure your Facebook API credentials. It indicates that the values are not able to successfully authenticate with the Facebook API. | If you receive this message, check your API key and secret and try again. |
Can't Load URL: The domain of this URL isn't included in the app's domains. | If you see the following error message when attempting to sign in using Facebook, the URL in your Facebook app is no longer valid: | Try setting the URL in Facebook again. |
App Not Setup | If you see the following error message when attempting to sign in using Facebook, your app is still in development mode and you need to set it to public mode: App Note Setup: This app is still in development mode, and you don't have access to it. Switch to a registered test user or ask an app admin for permissions. | Check to ensure that your app permissions are correct. |
Last modified: October 9, 2024