# Zendesk

> Connect Zendesk once for the workspace, and each call can update the caller's ticket or open a new one.

Source: https://app.activelens.ai/help/zendesk

An admin connects Zendesk once for the whole workspace, from
**Integrations → Zendesk**. After that, each call can update the caller's
ticket — or open a new one — with a summary of the call and the ticket fields
it talked about.

## Connect Zendesk

The connection needs three things from Zendesk. Sign in to Zendesk as an
admin, then:

1. **Your subdomain.** It's the first part of your Zendesk address: in
   yourcompany.zendesk.com, it's _yourcompany_. Type it into **Zendesk
   subdomain**. If your help center has its own web address, still use the
   one that ends in .zendesk.com.
2. **An admin's email.** Type the email address of a Zendesk admin into
   **Agent email** — usually your own. To see who is an admin, open **Admin
   Center → People → Team → Team members** and look for the **Admin** role.
3. **An API token.** Open **Admin Center → Apps and integrations → APIs →
   API tokens**, click **Add API token**, give it a description such as
   "ActiveLens", and click **Save**. Copy the token straight away — Zendesk
   shows it only once — and paste it into **API token**.

If Zendesk says that token access is off, turn it on first: open **Admin
Center → Apps and integrations → APIs → API configuration**, select **Allow
API token access**, and click **Save**.

Then press **Connect**. ActiveLens checks the login with Zendesk before
saving it, and **Test** on the same page checks it again at any time. The
**How to connect** button on the page shows these steps with pictures.

### Allow CCs

For tickets to CC people from a call, Zendesk must allow CCs. Open **Admin
Center → Objects and rules → Tickets → Settings**, and under **CCs and
followers** select **Allow CCs**, then click **Save**. Who may be CC'd is set
under **CC** on the Zendesk page.

## After a call

By default, every phone call of 30 seconds or more gets a **Zendesk ticket**
action. It works in three steps:

1. **Find the ticket** — the caller's open ticket, found by their phone
   number first, then by numbers said on the call, their name or business,
   and finally the call's topic. When none fits, a new ticket is drafted.
2. **The fields** — values for the ticket fields you chose, such as its type,
   priority or status, from what was said.
3. **Summary note** — a summary of the call, added to the ticket as a note.

What happens next depends on the **Mode** on the Zendesk page:

- **Review first** (the default) — the action waits among the call's
  actions. Someone checks it, changes anything that needs it, and presses
  **Do It Now**. Nothing reaches Zendesk before that.
- **Automatic** — the ticket is written right after the call. It waits for
  review instead when something is uncertain: when it isn't clear which
  ticket the call is about, or when the ticket was found only by the caller's
  name or the call's topic. You can also hold new tickets, and tickets with
  an empty required field.

Field changes can be undone from the action for 10 minutes after they are
written; a new ticket can't be undone. Sample calls, private calls and calls
in Trash are never written automatically. You can also add **Zendesk
ticket** yourself from **+** on any call.

## Zendesk settings

The rest of the Zendesk page sets what the action does: which calls get one
(**When it runs**), how the ticket is found, what a new ticket looks like,
which fields are filled and how, the summary note, and whose name the notes
are written in. Each section shows a live preview of a sample call, and one
**Save** applies them all.

## Caller lookup

After a call, ActiveLens looks the caller up in Zendesk by their number, or by
a meeting attendee's email. What it finds shows on the left of the call page, with
a link to open it, and it looks again each time that panel opens, so you see the
record as it is now. The desktop app shows the same thing during a call.
Nothing is written to Zendesk.

It is on by default. To stop it, turn off **Caller lookup** on
**Integrations → Zendesk**.

## Disconnect Zendesk

**Disconnect** on the Zendesk page removes the login and these settings.
Tickets already written stay as they are in Zendesk. To stop the token
working too, delete it in Zendesk under **API tokens**.

## Related

- [Freshdesk](/help/freshdesk)
- [Connect an integration](/help/connecting-an-integration)
- [Actions on a call](/help/action-items)
