# Use Zendesk Integration

Once Cloud Voice is linked to your Zendesk account, calls and Zendesk records stay in step automatically. This page walks through each capability the integration unlocks and points you to the setup guide for the ones that need configuring.

## Click to call

Turn any phone number shown in Zendesk into a one-click outbound call.

**Before you start:** Add the Cloud Voice App for Google Chrome extension to your browser and connect it to your Cloud Voice App (Web) session.

**How it works:** Numbers that appear on a Zendesk page become clickable. Selecting one places the call straight from your assigned Cloud Voice extension.

![Cloud Voice, a clickable phone number highlighted on a Zendesk record](/images/pbx/click-2-call-on-zendesk.png)

## Call popup

Bring up a caller's Zendesk profile automatically around the moment of a call.

**Before you start:** Stay signed in to at least one of these clients:

- Cloud Voice App (Desktop)
- Cloud Voice App (Web)

:::note
If you close the browser or the Cloud Voice App (Web) tab, incoming calls will not reach you. Installing the Cloud Voice App for Google Chrome extension keeps the call popup working even when the browser window is closed.
:::

**How it works:** When you receive or answer an inbound call from a Zendesk contact, or wrap up a call with one, a new browser tab opens showing that contact's details. You can also open the contact from the call window yourself at any point during the call. To choose which events trigger the popup, see [Set up Call Popup](/pbx/integrations/zendesk/set-up-call-popup-for-inbound-calls/).

| Automatic popup | Manual popup |
| --- | --- |
|  ![Cloud Voice, a Zendesk contact card opening on its own for an inbound call](/images/pbx/zendesk-contact-pop-up.png) | ![The contact link inside the active call window](/images/pbx/manually-open-call-popup-hp.png) |

:::caution
Your browser may block the popup. If that happens, click the blocked-content icon in the address bar, allow the popup and site redirection, then click **Done**.
:::

![Cloud Voice, browser prompt to allow a blocked popup window](/images/pbx/zendesk-pop-up-window-blocked.png)

## Contact synchronization

Every inbound and outbound call runs a lookup against your Zendesk contacts. When the number matches an existing Zendesk contact, that contact is copied into the linked Cloud Voice phonebook. Synced entries are read-only within Cloud Voice.

:::note
Synchronization runs one way only, from Zendesk into Cloud Voice. That is why synced entries cannot be edited in Cloud Voice: make any changes in Zendesk, and they flow back on the next lookup.
:::

For details, see [Set up Contact Synchronization from Zendesk](/pbx/integrations/zendesk/set-up-contact-synchronization-from-zendesk/).

![A Zendesk contact mirrored into a Cloud Voice phonebook](/images/pbx/zendesk-sync-phonebook-contact.png)

## Contact creation

When an associated extension calls or takes a call from a number Zendesk doesn't recognize, a new contact can be added in Zendesk, either automatically or on demand.

For details, see [Set up Contact Creation for Zendesk](/pbx/integrations/zendesk/set-up-automatic-contact-creation-for-zendesk/).

![A new Zendesk contact generated from an unknown caller's number](/images/pbx/zendesk-auto-create-new-contact.png)

## Automatic ticket creation

Whenever an extension tied to a Zendesk user takes an inbound call from, or dials an outbound call to, a Zendesk contact, a ticket is opened automatically on that contact's detail page.

For details, see [Set up Automatic Ticket Creation for Zendesk](/pbx/integrations/zendesk/set-up-automatic-ticket-creation-for-zendesk/).

![A support ticket created automatically from a call in Zendesk](/images/pbx/zendesk-created-ticket.png)

## Call journal

View call history and recordings without leaving Zendesk.

:::note
This works only when [automatic ticket creation](/pbx/integrations/zendesk/set-up-automatic-ticket-creation-for-zendesk/) is enabled.
:::

- With automatic ticket creation turned on, the call types you choose (inbound, outbound, and missed) are written into the auto-created tickets on each Zendesk contact's detail page.

  ![A call log entry recorded inside a Zendesk ticket](/images/pbx/zendesk-view-call-log.png)

- If you also enable [call recording playback](/pbx/integrations/zendesk/enable-call-recording-playback-in-zendesk/), the matching recording appears in the ticket and can be played back there.

  ![A call recording available for playback within a Zendesk ticket](/images/pbx/zendesk-call-recording.png)

## Chat journal

When an external chat between a user (on a Cloud Voice extension) and a Zendesk contact ends, whether the user closes it or the system does, the full message thread is synced to Zendesk so you keep a complete record of every customer conversation.

To review a synced conversation, sign in to Zendesk and open the contact's detail page.