Zendesk
Connect Zendesk once for the workspace, and each call can update the caller's ticket or open a new one.
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:
- 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.
- 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.
- 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:
- 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.
- The fields — values for the ticket fields you chose, such as its type, priority or status, from what was said.
- 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.