Articles on: Integrations

How to connect Twitter (X) with Crisp

Learn how to connect X (Twitter) Direct Messages to Crisp so your team can receive and reply to DMs from the Inbox.


The X (Twitter) integration connects Direct Messages to Crisp. It requires the right X developer access and app permissions, so most setup work happens in the X Developer Portal before the credentials are added to Crisp.


The X (Twitter) integration is available from the Crisp Mini plan.


This integration requires the X/Twitter Enterprise plan. Without the required X developer access, the integration will not work.



Create your X project and app


  1. Go to the X Developer Portal.
  2. Click Create Project.
  3. Give the project a name.
  4. Select Making a bot as the use case.
  5. Add a project description.
  6. Create the app and give it a name.
  7. Copy the generated API Key, API Secret Key, and Bearer Token.



Allow Direct Message permissions


  1. Open the Settings tab of your X app.
  2. Under User authentication settings, click Setup.
  3. Enable OAuth 1.0a.
  4. Under App permissions, select Read + Write + Direct Messages.
  5. Add your Callback URI / Redirect URL, Website URL, Terms of service URL, and Privacy policy URL.
  6. Save the settings.


X app permissions for Direct Messages



Generate access credentials


  1. Open the Keys and tokens tab of your X app.
  2. In Access Token and Secret, click Generate.
  3. Copy the Access Token and Access Token Secret.


Generate X access token and secret



Apply for the required X API access


  1. Go to X API products.
  2. Apply for the required access tier for Direct Messages and Account Activity.
  3. In the application details, describe that the app will use Direct Messages for customer support.
  4. Wait for approval from X.


The X Developer Portal can change labels and plan names over time. Follow the current X interface while making sure your app has Direct Message and Account Activity access.



Set up the Account Activity API


  1. Once approved, go to Dev environments.
  2. In Account Activity API / Sandbox, click Set up dev environment.
  3. Give the environment a name.
  4. Select the app created earlier.


Set up the X Account Activity API



Link X Direct Messages with Crisp


  1. Go to Crisp.
  2. Open Plugins → Twitter DM.
  3. Paste the credentials generated from the X Developer Portal.
  4. Save the configuration.


The video below was recorded before changes to the X Developer Portal. The general setup remains similar, but the current interface may use different labels.




Troubleshooting


I do not receive X Direct Messages in Crisp


Check these points first:


  1. Regenerate and update all X API tokens in the X Developer Portal, then save the new values in Crisp.
  2. Make sure OAuth permissions are set to Read + Write + Direct Messages.
  3. Confirm the Account Activity API dev environment is properly configured.
  4. In X message settings, make sure message requests are allowed and Filter low-quality messages is disabled if it blocks expected messages.


Learn more about centralizing social messaging from the Crisp social inbox page.


Updated on: 03/05/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!