# Connecting X to Ruut Chat

## What it is

Connecting X brings your X (formerly Twitter) Chat conversations into your Ruut Chat workspace. Messages sent to your X account arrive in a Ruut inbox, and your team can read and reply to them without sharing the X login. The connection runs through **Ruut Connect**, a small browser extension that links your X account to your workspace with your permission.

## ![](https://app.ruut.chat/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBK2F6Qnc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--67db13e19e8bc13354aa4dad748aa60f3ca766b4/Screenshot%202026-10-19%20at%2010.05.47%E2%80%AFPM.png)Why it matters

When X messages live in one person's account, they get missed, nobody else can answer them, and there's no record in your workspace. Once X is connected, those conversations land in your Ruut inbox next to your other channels, so anyone on your team can pick them up, assign them, and reply.

## What to know before you connect

This channel works a little differently from most, so it's worth reading before you start.

* **What gets shared.** Connecting shares your X session and its Chat signing and decryption keys with Ruut. This is what allows your team to receive and reply to messages. Ruut stores these encrypted.

* **What doesn't get shared.** Your PIN and message history are not copied by the extension.

* **You stay in control.** You choose which account to connect, and you can disconnect in Ruut at any time to remove this access.

* **Current limits.** One-to-one text conversations are supported. 

## Before you start

Have ready:

* **A computer** with Chrome.

* **The Ruut Connect extension installed.** It's the same extension used for LinkedIn, so if you've already set it up, you can skip this. If not, follow the install steps in our LinkedIn guide first.

* **Admin access** to your Ruut Chat workspace, so you can add an inbox

* **Your X login** for the exact account you want to connect, and the **passcode** you use to unlock X Chat

## How to set it up: step by step

### Step 1: Open Workspaces and click "Add Inbox"

In Ruut Chat, open **Settings → Workspaces** and click **Add Inbox** in the top right. The setup wizard has four stages: **Choose Channel → Create Workspace → Add Agents → Voilà**. On the first stage, select **X**.

### ![](https://app.ruut.chat/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBK216Qnc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--e7a64349d16a063f27296a469164560bec5193b9/Screenshot%202026-10-19%20at%207.05.37%E2%80%AFPM.png)

### Step 2: Name your workspace and continue

On the **Connect X** screen, enter a **Workspace name** that makes this inbox easy to recognise later, for example "Support X" or the name of your brand. Read the note on screen: Ruut Connect will ask permission to securely share your session and Chat keys, then bring you back here to confirm your profile. Click **Continue with X**.


### ![](https://app.ruut.chat/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBK3F6Qnc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--f6094635621f1ee8e7c4049ded7ff58481e679d3/Screenshot%202026-10-19%20at%2010.15.40%E2%80%AFPM.png)Step 3: Sign in to X

Ruut Connect opens with three stages: **Account access → Verify → Confirm in Ruut**. Click **Open X to sign in**, then sign in to the X account you want to connect, in the same browser. If you chose the wrong account, click **Cancel this connection** and start again.


### ![](https://app.ruut.chat/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBK3V6Qnc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--d56014a03748b2ad766ddf2254f414291e5bce4f/Screenshot%202026-10-19%20at%2010.06.14%E2%80%AFPM.png)Step 4: Unlock X Chat if asked

X may show an **Enter Passcode** screen asking for the temporary passcode sent to your device. Enter the four digits to continue. If nothing arrives, click **Resend passcode**.

### ![](https://app.ruut.chat/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBK3l6Qnc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--516cecd046c59b00eb6b8283aa082614ecb380d2/image.png)Step 5: Review access and allow it

Back on the Ruut Connect page, you'll see **"Your X session is ready. Review access below to continue."** Read the **Your account, connected securely** note, then tick the box that says **Allow Ruut to use this X session and Chat keys for this workspace**. The **Connect this X account** button stays greyed out until the box is ticked. Click it when ready.


### ![](https://app.ruut.chat/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBKzJ6Qnc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--49eb0c68500f402901c4034f88970ccb1bb08860/Screenshot%202026-10-19%20at%2010.06.34%E2%80%AFPM.png)Step 6: Confirm your X account in Ruut

Ruut brings you back to the wizard with a **Confirm your X account** card showing the account name and handle. It also confirms that your session, Chat keys, and realtime connection have been verified. Check that it's the right account, then click **Connect workspace** to start receiving messages. Click **Cancel** if it isn't.


### ![](https://app.ruut.chat/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBKzZ6Qnc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--d28f0f4c3c0c84cf117eaff8a6bb1e104da14dce/Screenshot%202026-10-19%20at%2010.15.59%E2%80%AFPM.png)Step 7: Add agents to the inbox

On the **Add Agents** stage, open the **Pick agents for the inbox** dropdown, select the teammates who should handle X messages, and click **Add agents**. Only the agents you select here can see and reply to messages in this inbox. If you're an administrator and want access to every inbox, add yourself too.


### ![](https://app.ruut.chat/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBKyt6Qnc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--f45537ce241ddb8c3ef5f0615ccc10b97d2b2f63/Screenshot%202026-10-19%20at%2010.16.06%E2%80%AFPM.png)Step 8: Your inbox is ready

When the last stage finishes, Ruut confirms your inbox is ready. Open it to start receiving and replying to X messages.


## ![](https://app.ruut.chat/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBL0N6Qnc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--31c6e4d574728e862ad21e6e3bebce7b77707b6c/Screenshot%202026-10-19%20at%209.41.37%E2%80%AFPM.png)If you open Ruut Connect on its own

If you open the Ruut Connect extension directly, you'll see a page titled **"A simple connection. A shared workspace."**listing LinkedIn and X as **Available**. This page doesn't start a connection by itself. Click **Open Ruut**, then begin from Settings → Workspaces as in Step 1.

## ![](https://app.ruut.chat/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBL0d6Qnc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--eb8c847b8da8109e0c5b86b721fde2686cca1c0a/Screenshot%202026-10-19%20at%2010.06.47%E2%80%AFPM.png)Final checklist

* You're on a computer using Chrome.

* The Ruut Connect extension is installed and switched on

* You signed in to the correct X account

* You ticked the permission box before connecting

* The Confirm your X account card showed the right name and handle

* You added the agents who need access

* A test message sent to your X account appears in the new inbox

## Common problems

**The Connect this X account button is greyed out** — The permission box isn't ticked yet. Tick **Allow Ruut to use this X session and Chat keys for this workspace**, and the button becomes active.

**No passcode arrives** — Click **Resend passcode** on the X screen and check the device(it will be an alternate device that your X account is logged in to) X says it sent the code to.

**The wrong X account shows on the confirmation card** — Click **Cancel**, sign out of X in that browser, sign in to the right account, and connect again.

**Teammates can't see the X inbox** — Only agents added to the inbox can see its messages. Add them from the inbox settings, or in the Add Agents stage during setup.

**You want to stop sharing access** — Disconnect the X inbox in Ruut. This removes the access you granted.

## What's next

Once X is connected, set up labels and automation to route X conversations to the right people, and consider connecting LinkedIn the same way so your social inboxes live in one place.