# Описание функционала

## Отображение карточки клиента <a href="#otobrazhenie_kartochki_klienta" id="otobrazhenie_kartochki_klienta"></a>

{% hint style="info" %}
Функция будет активна, если в настройках модуля на АТС включена опция «**Загружать на портал историю звонков**».\
В противном случае будет доступна только функция click2call.
{% endhint %}

При звонке отображается карточка телефонного звонка, в которой:

* Выводится информация по клиенту, по активным сделкам.
* Есть возможность добавить комментарий к телефонному звонку.
* Есть возможность выставить новый счет или зарегистрировать новую сделку.

<figure><img src="/files/1BHSz3Y8Hi9gCA7uD9kT" alt=""><figcaption><p>Карточка телефонного звонка</p></figcaption></figure>

Модуль автоматически регистрирует звонок в Bitrix24, для чего ищет в CRM соответствующий номеру контакт. Если контакт найден, то звонок будет привязан к найденному объекту.

## Создание сущностей <a href="#sozdanie_suschnostej" id="sozdanie_suschnostej"></a>

При работе с телефонией, интеграция может создавать следующие сущности:

* **Контакт** - по умолчанию создается с именем «Без имени».
* **Сделка** - использует созданный контакт, в заголовке указывается номер телефона.
* **Лид** - использует созданный контакт.

Если в настройках модуля включена опция «**Создавать в CRM сущности, связанные со звонком (Лид / сделка / контакт)**» и контакт не был найден по номеру телефона, то модуль создаст в CRM необходимые сущности.

{% hint style="success" %}
**Тип создаваемой сущности определяется режимом в настройках CRM**. Существует:

* **Простой режим** - при котором будет создаваться сделка, а не лид.
* **Режим повторных продаж** - будет создана Сделка или Лид даже если сущность в CRM найдена. (Но не будет создаваться если есть активная сделка/лид или номер внесен в черный список crm).
  {% endhint %}

### **Порядок назначения ответственных для новых контактов**:

* «**Пропущенный**» - ответственным за сущность будет назначен «**Ответственный за пропущенные звонки**» (настройка выполняет в модуле, на стороне MikoPBX). Если настройка не заполнена, то ответственным будет назначен один из участников звонка (первый, у кого зазвонил телефон).
* «**Вызов отвечен**» - ответственным будет назначен тот, кто ответил на вызов.

{% hint style="warning" %}
Если вызов поступает на очередь (группу сотрудников), то ответственный в сущности по умолчанию будет установлен тот, на кого вызов был направлен первее. После поднятия трубки или завершения звонка ответственный будет скорректирован. Это поведение связано с особенности работы API Bitrix 24
{% endhint %}

## История звонков <a href="#istorija_zvonkov" id="istorija_zvonkov"></a>

История звонков доступна в разделе «**Телефония**» - «**Детализация звонков**»

<figure><img src="/files/z0yBk3UAqfoaV7MAs8on" alt=""><figcaption><p>Раздел "Телефония" -> "Детализация звонков"</p></figcaption></figure>

История отображается в карте сделки:

<figure><img src="/files/YLc6fqPRsgrkdTIst5eV" alt=""><figcaption><p>Карта сделки</p></figcaption></figure>

Также, она отображается в карточке клиента и в списке "Мои дела":

<figure><img src="/files/6kOsmWPwNkzgoLESnoc0" alt=""><figcaption><p>Карточка клиента</p></figcaption></figure>

## Записи разговоров <a href="#zapisi_razgovorov" id="zapisi_razgovorov"></a>

Запись разговоров - это в первую очередь функция телефонной станции.

Если есть необходимость загружать телефонные разговоры на портал Bitrix24, то необходимо в настройках модуля MikoPBX включить соответствующий флаг:

<figure><img src="/files/vGeU7g4JX3aTeXYZLwmy" alt=""><figcaption><p>Флаг "Загружать на портал историю звонков"</p></figcaption></figure>

Портал Bitrix24 позволяет прослушать телефонный разговор непосредственно в браузере или скачать файл записи разговора на ПК сотрудника.

<figure><img src="/files/5DNPvY40E4QiJx8SI7xh" alt=""><figcaption></figcaption></figure>

## Исходящие из Bitrix24 <a href="#isxodjaschie_iz_bitriks" id="isxodjaschie_iz_bitriks"></a>

После настройки портала появится возможность совершать звонки из карточки клиента:

<figure><img src="/files/Sa2NkcOnyGSxmq8oFTax" alt=""><figcaption><p>Возможность совершать звонки из карточки клиента</p></figcaption></figure>

Всюду, где имеется гиперссылка-телефон или «кнопка с трубкой» будет возможность совершить исходящий звонок средствами АТС MikoPBX.

## Перехват на ответственного <a href="#perexvat_na_otvetstvennogo" id="perexvat_na_otvetstvennogo"></a>

Для настройки функции необходимо в интерфейсе модуля активировать опцию «**Использовать перехват на ответственного**», а так же настроить параметр «**Длительность попытки звонка на ответственного**».

<figure><img src="/files/AAkFbyCy2GmZlJnnG4CZ" alt=""><figcaption><p>Параметры внутри настройки модуля в интерфейсе MikoPBX</p></figcaption></figure>

Обязательно опишите [входящий маршрут](/mikopbx/manual/routing/incoming-routing.md). При поступлении входящего звонка система проверит наличие ответственного в Bitrix24:

* Если ответственный определен, то вызов будет направлен на него.
* Если ответственный не определен, или дозвониться до него не вышло, то вызов будет направлен по описанному входящему маршруту.

## Отчеты <a href="#otchety" id="otchety"></a>

{% hint style="success" %}
Подробную информацию по отчетам вы можете найти [здесь](https://helpdesk.bitrix24.ru/open/19342270/). Это официальный блог Bitrix24.
{% endhint %}

В разделе CRM доступен ряд стандартных отчетов.

* «**Отчет по делам**» - «**Выполнено менеджерами**»:

<figure><img src="/files/RVZ3qMntakzw9jquB0d3" alt=""><figcaption></figcaption></figure>

* Есть возможность добавить свой произвольный отчет по делам. Звонки сотрудника «**CRM**» - «**Еще**» - «**Мои дела**»:

<figure><img src="/files/yARaKjVAL5G9LIDc2yxs" alt=""><figcaption></figcaption></figure>

* Есть возможность **прослушать и скачать запись** разговора из карточки «Дела»:

<figure><img src="/files/8Vt3fVB9BZkM1cDUeAby" alt=""><figcaption></figcaption></figure>

* «**CRM**» - «**Еще**» - «**Мои дела**» - «**Сводный отчет по делам**»:

<figure><img src="/files/llMw6yDTzGuw6fKb1sHz" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mikopbx.com/mikopbx/modules/miko/module-bitrix24-integration/functions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.