# Use Bitrix24 CRM Integration

With Cloud Voice linked to Bitrix24 CRM (Customer Relationship Management, the app your team uses to track leads, contacts, and conversations), extension users can place and log calls without leaving the CRM, and their conversations, chats, and contacts stay in sync across both systems. This page walks through each capability and what it takes to use it.

## Click to Call

Turn any phone number shown in Bitrix24 into a one-click call placed through your Cloud Voice extension.

**Before you use it**

- Install the Cloud Voice extension for Google Chrome, and set up the Cloud Voice App web client to work alongside it.
- Stop routing calls through Bitrix24 Telephony so that dialing is handled by Cloud Voice instead. In Bitrix24, go to **CRM > Settings > CRM Settings > Other > Other Settings > Format** and disable the option.

  ![Bitrix24 CRM settings with call routing through Bitrix24 Telephony turned off](/images/pbx/disable-call-from-bitrix24.png)

  :::caution
  If Bitrix24 Telephony is left enabled, clicking a number dials through Bitrix24's own phone service instead of your Cloud Voice extension, so Click to Call will not work. Confirm this option is off before you test.
  :::

**How it works**

Click the call icon ![Call icon in Bitrix24](/images/pbx/bitrix24-call.png) to reveal the detected phone number in Bitrix24, then click the number. The call is dialed straight out through the PBX (Private Branch Exchange, the phone system behind your Cloud Voice service) extension tied to your account.

![Cloud Voice, placing a call from a phone number displayed on a Bitrix24 record](/images/pbx/click-2-call-on-crm.png)

## Call Popup

When a call involves a known CRM contact, Bitrix24 can surface that contact's record automatically.

**Before you use it**

Keep at least one of these clients signed in:

- The Cloud Voice App desktop client.
- The Cloud Voice App web client.

  :::note
  If the user closes the browser or the Cloud Voice App web client tab, calls can no longer be received. Installing the Cloud Voice extension for Google Chrome keeps the popup tab working even when the browser is closed.
  :::

**How it works**

When a Bitrix24 user receives or answers an inbound call from a CRM contact, or wraps up a call with one, a new browser tab opens on its own to show that contact's details. The user can also open the record by hand from the call window while the call is still connected.

- **Automatic popup**: the record opens on its own at the configured moment in the call.

  
  ![Cloud Voice, a Bitrix24 contact record opened automatically in a browser tab](/images/pbx/crm-contact-pop-up.png)

- **Manual popup**: the user opens the record from the call window during the call.

  ![Opening a contact record by hand from the active call window](/images/pbx/manually-open-call-popup.png)

:::note
For details on when and how the record opens, see [Set up Call Popup](/pbx/integrations/bitrix24/set-up-call-popup-for-inbound-calls/).
:::

:::note
The browser may block the popup tab. If that happens, click the blocked-content icon in the address bar, allow pop-ups and redirects for the site, and then click **Done**.

![Browser prompt for allowing a blocked popup window](/images/pbx/pop-up-window-blocked.png)
:::

## Call Journal

Every outbound, inbound, and missed call is logged to the CRM automatically, so your team keeps a record of each conversation.

- To review the logs, sign in to Bitrix24 and open a contact detail page under **CRM > Leads** or **CRM > Customers > Contacts/Companies**.

  ![Call records logged on a Bitrix24 contact detail page](/images/pbx/call-journal.png)

- If you have turned on [call recording playback](/pbx/integrations/bitrix24/set-up-call-journal-to-bitrix24-crm/#set-up-call-journal-to-salesforce-crm__recording), users can also play back recordings directly within the CRM.

  ![A call recording available for playback inside Bitrix24](/images/pbx/call-recording.png)

## Chat Journal

When an external chat session between an extension user and a CRM contact ends, whether the user closes it or the system does, every message from that session is synced to Bitrix24, giving your team the full history of each customer interaction.

To read the synced messages, sign in to Bitrix24 CRM and open the contact detail page.

## Contact Synchronization

An inbound call from a Bitrix24 contact, or an outbound call to one, triggers a contact lookup. When Bitrix24 holds a contact with a matching number, that contact is copied into the linked PBX phonebook, where it stays read-only.

For details, see [Set up Contact Synchronization from Bitrix24 CRM](/pbx/integrations/bitrix24/set-up-contact-synchronization-from-bitrix24-crm/).

![A Bitrix24 contact synced into a read-only PBX phonebook entry](/images/pbx/sync-phonebook-contact.png)

## Lead or Contact Creation

When a linked extension calls or is called by a number that Bitrix24 doesn't recognize, a new lead or contact can be created, automatically or by hand.

For details, see [Set up Lead or Contact Creation for Bitrix24 CRM](/pbx/integrations/bitrix24/set-up-automatic-lead-or-contact-creation-for-bitrix24-crm/).

![A new Bitrix24 contact created from a call with an unknown number](/images/pbx/auto-create-new-contact.png)