﻿# Zadarma IP telephony

> [HTML Version](telephony-zadarma.html)

The module allows you to connect the Zadarma IP telephony provider to the BRIX system. Enable it to make and receive calls in the BRIX interface, identify clients by the phone number, open an associated app page when answering a call and listen to call recordings on the page.

````
начало внимание

````
Make sure your Zadarma account is active, before starting the installation.

````
конец внимание

## ````
Enable the module

1. Go to **Administration > Modules > Zadarma** and check the **Enable Module** box. 

2. Copy the **Webhook URL** field data. 

3. Sign into your Zadarma account. Go to **Settings > Integrations and API**. 

4. On the opened page, stay in the **Integrations** tab and select the **Notifications **box in the in **Zadarma services **section**.**

5. On the right pane that opens, in the **Step 2. Enter Links** area, paste the webhook that you [previously copied](#copy_webhook) into the **About PBX calls** field. A list of events opens. Select those for which you need notifications to be sent to BRIX.  
  
Then paste the same webhook to the **About events** field and also select the events.  
**(zadarma_int_2.png)**



6. Close the pane and switch to the **Keys and API** tab. Click **Create Keys**.  
**(zadarma_int_3.png)**



7. Copy the provided authentication key form the **Key** field and the secret key from the **Secret** field.  
**(zadarma_int_4.png)**

8.  Go to the BRIX interface, open **Administration > Modules > Zadarma**. Paste the key to the **API key\*** field and the secret key to the **API secret\*** field

**(zadarma-4.png)**

9. Click the **Test connection** button. If the connection between the systems is established, you will see a notification. 

10. Save the settings. 

## Merge users

After the connection with the provider is established, you need to match the IP-telephony provider users and BRIX users. 

1. On the settings page of the module, click the **Set up** button. 

2. In the opened window, specify an BRIX user for each provider extension number.

**(zadarma-5.png)**

3. Click **OK**.

Please note, the users or provider extension numbers are imported automatically. To add new users, create them in the provider interface. Read more in the [Zadarma IP-telephony documentation](https://zadarma.com/en/support/faq/pbx/how-to-create-and-set-internal-numbers/).

## Set up processing of an incoming call

After connecting the telephony, it is necessary to configure the processing of incoming calls. To do this, in the **Incoming call processing** section, fill in the following fields:



- **Associate with an app**. Specify the app where items with information about the client and the call will be created and stored. Note that the selected app's form should include a field of [Phone number](360009707032.md#phone-number) type.

- **Contact phone number**. Choose a field of the **Phone number** type from the context of the specified app where the client's phone number will be recorded.

- **Disable item creation**. Select **Yes** to disable automatic contact creation after a call ends. This prevents duplicate or unnecessary records from being added to the app containing your contact database, specified in the **Link to app** field.

- **Call page**. Click the **Set Up** button to modify the design of the notification that pops up during a call. In the opened window, you can edit the [title template](360007679591.md) and select the fields that will be displayed on the page.

**(zadarma_int_5.png)**

After having set up all the parameters, click **Save** to apply changes.



