Skip to main content

Reconnect Zendesk Chat

Use these steps to reconnect Zendesk Chat to Assembled with a new authorization, and to make sure the old authorization no longer works.

If you're here because of the November 13, 2026 security incident: Please reconnect Zendesk Chat using the steps below, and check that the old Assembled authorization has been removed in Zendesk. Disconnecting Zendesk Chat in Assembled doesn't make the old authorization stop working. For more about the incident, see November 13, 2026 security incident.

Who does this

  • An Assembled admin, or someone with a role that can configure third-party integrations.
  • A Zendesk admin who can manage Zendesk Chat and approve app access. We recommend using a shared service account rather than a personal one.

Before you start

  • Reconnect Zendesk Support first. Zendesk Chat uses the Zendesk Support authorization, so it can't connect until Support is working. See Reconnect Zendesk Support.
  • Note any Zendesk Chat settings you've set up in Assembled, such as queue rules and agent state mappings, so you can check them afterward.
  • Check where Zendesk Chat appears in Configure > Third-party integrations. If it still shows as connected under In use, contact Support and we'll help you reconnect it.

Steps

  1. In Zendesk, have your admin check whether an Assembled authorization for Zendesk Chat is still active. If it is, revoke it. If you can't find it or can't revoke it, contact Support and we'll help.
  2. In Assembled, go to Configure > Third-party integrations, select Available, and search for Zendesk Chat.
    The Zendesk Chat card on the Available filter of Third-party integrations, with its Connect integration button.
  3. On the Zendesk Chat card, select Connect integration. If it says Requires Zendesk authorization, reconnect Zendesk Support first. Sign in as a Zendesk admin and approve access.
  4. Back in Configure > Third-party integrations, check that the sync rows on the Zendesk Chat card are green.

If a step doesn't match what you see, or you can't finish it, contact Support. We're working through these with customers individually and will help you finish reconnecting.

How to confirm it's working

  • The sync rows on the Zendesk Chat card are green and show a recent successful sync. The Connected tag on its own doesn't confirm that data is flowing.
  • Recent Chat contacts and agent states in Assembled match what you see in Zendesk. Agent states can take about five minutes to appear.
  • If a sync row is red, hover over it to see the error, and include that text when you contact Support.

When you'll see data

Once Zendesk Chat is connected, Assembled checks for new contacts and agent states about every 15 seconds. After you reconnect, allow time for the next scheduled sync. Reports can take a little longer to refresh.

Restoring missed data

Reconnecting normally starts a backfill of your Zendesk Chat history automatically. While it runs, the card shows Backfill in progress, and when it's done it shows the date it's backfilled until. If you still see gaps from while Zendesk Chat was disconnected, contact Support and let us know which dates are affected.

Things to watch for

  • Reconnect Zendesk Support first. Zendesk Chat can't connect until Support is working.
  • Remove the old authorization in Zendesk. Disconnecting or reconnecting in Assembled doesn't make it stop working. If you can't remove it, contact Support.
  • Check your settings afterward. Compare your queue rules and agent state mappings with the notes you made before reconnecting.

Need help?

If something doesn't look right, contact our Support team and include any error text you see on the Zendesk Chat card. Please don't send tokens or passwords by email or chat. For more about how the integration works, see Zendesk Chat integration.

Still have questions?