Third-Party Integrations: X
Allow users to log in and sign up with their X (formerly Twitter) account, an option available under our Social Login integrations.
Prerequisites
To set up X, you must have an X account with a mobile number set on it.
Activate or Deactivate Integration
The X integration is disabled by default and needs to be activated before use.
- Visit Settings -> General -> Third-Party Integrations.
- Find the X integration and click the "Activate" link located on the left of the table.
- The page will reload confirming the integration has been activated.
The integration can be deactivated by following the above process, but using the "Deactivate" link instead.
Integration Settings
If you don't already have an X developer account, you will need to apply before you're allowed to create an application. Please follow our X Developer Application guide to complete this process.
To set up the X integration, you will need to set up an X application, follow the steps below.
- Visit the X Developer portal - https://developer.twitter.com/en/portal/dashboard - and sign in to your X account.
-
Click "Projects & Apps" in the sidebar and then "Overview".
-
Click on "New Project".
-
Give your project a name and click "Next".
-
Select 'Build customized solutions in-house' for the use case of the project, and click "Next".
-
Enter a description for the project, and click "Next".
-
Enter a name for the app that will belong to the project, this must be unique, so it may be worth choosing a name that related to your organisation's name, and then click "Complete".
-
You will now see the API key and secret, these should be copied in to SupportPal.
-
Click on "Settings" under X on the third-party integrations page, and enter the API key and API key secret. Click "Save".
-
Go back to X and click on "App Settings" at the bottom. Scroll to Authentication Settings and click on "Edit".
-
Toggle the "Enable 3-legged OAuth" and "Request email address from users" options and copy the callback URL from the SupportPal integration settings page. Enter the remaining required details and click "Save".
Enabling X Social Login
To enable the X login option for your users, follow the steps below.
- Go to Settings -> Users -> Social Login, and click "Manage" on the right of the X box. If the option is not there, please ensure you have completed the above set-up of the integration correctly.
- Press the toggle to enable the social login. If you have multiple brands, you will have the option to enable or disable for each brand.
- Press "Submit".
It should now be successfully configured, we recommend to try the login as a test user to verify it works.
Troubleshooting
Add Mobile Phone
Your X account must have a mobile phone set on it to be able to create applications. Please set up a mobile phone and then try to create the application again.