> For the complete documentation index, see [llms.txt](https://docs.itgrix.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.itgrix.ru/blog/asterphone-v-bitriks24.md).

# AsterPhone в Битрикс24

Приложение [Itgrix AsterPhone](https://marketplace.1c-bitrix.ru/solutions/itgro.asterphone/?utm_source=bz) распространяется в виде модуля (решения, локального приложения) для коробочных порталов 1С-Битрикс24.

## Установка

{% hint style="warning" %}
На сервере Битрикс24 должна быть библиотека **libcurl**
{% endhint %}

1. Зайдите в интерфейс администрирования портала.
2. Раздел **Marketplace - Каталог решений**
3. В поиске введите **Asterphone**
4. Установите решение “Itgrix AsterPhone” (**Тестировать**)

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

**Важно.**\
Функция Block third-party cookies (Блокировать сторонние файлы cookie) в браузере должна быть отключена.

Настройки - Конфиденциальность и безопасность - Файлы cookie и другие данные сайтов

\- Блокировать сторонние файлы cookie

\\

<figure><img src="/files/7PgdrGU8Zzen2NmEiaKZ" alt=""><figcaption></figcaption></figure>

## Настройка

### Данные для подключения к Asterisk

В интерфейсе администрирования портала зайдите в Настройки -> Настройки модулей, в выпадающем списке выберите Itgrix AsterPhone, вкладка Настройки подключения (адрес: https\://<домен>/bitrix/admin/settings.php?lang=ru\&mid=itgrix.asterphone):

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

### Учетные данные пользователей

#### Добавление пользователей

В интерфейсе администрирования портала зайдите в Настройки -> Настройки модулей,

в выпадающем списке выберите Itgrix AsterPhone, вкладка Учетные данные пользователей.

Для добавления новой записи заполните поля:

1. ID\_USER - ID пользователя в портале 1С-Битрикс24
2. LOGIN - Внутренний номер телефона (extension) в Asterisk ([настроенный для использования WebRTC](https://docs.itgrix.ru/blog/nastroika-webrtc-v-asterisk-freepbx))
3. PASSWORD - Пароль для внутреннего номера (secret) в Asterisk

И нажмите кнопку Сохранить.

В дальнейшем можно редактировать или удалять записи.

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

## Руководство пользователя Itgrix AsterPhone

{% embed url="<https://youtu.be/WXPZ10yFHPE>" %}

## Интерфейс AsterPhone

### Автоматическая авторизация

При открытии страницы портала Itgrix AsterPhone автоматически авторизуется (если администратор портала Битрикс24 добавил данного пользователя в настройки AsterPhone).

Иконка приложения находится в правом нижнем углу страницы портала. Ее вид отражает статус авторизации:

![](https://lh3.googleusercontent.com/o5mFRHqqohv2HTXe6FMRoMKZMuRe9Tc7yPa-m5H2Dh0RQ2DIFX60Buv5Y48Z_78bfuKYBqjzjEebTDSCA4nvmt1flS4MPvngGkafmGbSmkMa5odKVkKcCkj5pSWarjdTAbzrIpynn_m_Vk1rIcoywOM)(цветная) - приложение успешно авторизовалось в Asterisk.

![](https://lh4.googleusercontent.com/sFhJvkoxaDpEEayB83sWPh8wAt2KirqpSQKj3Po3dEVafe7s_Bo_a7CHpWAQoH8Qxro17snV0uc2NqqfAWBqg6h64EJE1WYiw2iKBTfkVa4RcXpGcG6K9LtE6wi9BoB_jiP3clWdZ1f3TPfEHScVo3o)(серая) - для пользователя не настроен внутренний номер или ошибка авторизации в Asterisk.

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

### Панель приложения

По нажатию на иконку приложения отображается и скрывается панель приложения.\
Это может быть необходимо при работе с сущностями - панель может перекрывать кнопки Сохранить/Отмена.

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

В панели приложения отображаются:

1. Поле ввода номера с поиском по пользователям и сущностям.
2. Внутренний телефонный номер, с которым пользователь авторизован в Asterisk.
3. Меню настроек (в данной версии только отладочные функции и версия приложения).

## Входящий звонок

При входящем звонке появляется дополнительная панель для управления непосредственно звонком:

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

На скриншоте:

1. Иконка направления звонка (входящий/исходящий)
2. Имя пользователя или сущности CRM (лид, контакт, компания)
3. Номер телефона пользователя/сущности
4. Поднять трубку - ответить на звонок
5. Положить трубку - отклонить вызов

Во время разговора (в т.ч. при ответе на входящий) панель окрашивается в зеленый цвет:

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

На скриншоте:

1. Таймер
2. Меню быстрых переводов
3. Перевод звонка на пользователя - поиск по номеру
4. Номеронабиратель (DTMF)
5. Поставить звонок на паузу
6. Вкл/выкл микрофон
7. Положить трубку
8. Индикатор соединения с сервером Asterisk.

### Соединение с сервером Asterisk

Панель звонка отображается одновременно во всех открытых вкладках в данном браузере, но соединение с сервером телефонии Asterisk поддерживается только одно. Если отображается индикатор соединения, значит активное соединение привязано именно к данной вкладке.\
Важно в процессе звонка: если закрыть вкладку с соединением, звонок прервется.

При попытке закрыть вкладку с соединением AsterPhone выдаст стандартное предупреждение:

### Пауза

При постановке звонка на паузу панель звонка окрасится в желтый цвет.\
Чтобы вернуть звонок с паузы, нужно нажать на кнопку Play.

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

### Номеронабиратель (DTMF)

Во время звонка доступен тоновый набор, в т.ч. перевод звонка с помощью специальных команд тонового набора (\*\*номер и ##номер):

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

## Перевод звонка

### Перевод на пользователя

Звонок можно перевести на конкретного пользователя с помощью поиска по базе пользователей Битрикс24:

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

Здесь можно начать перевод кнопкой звонка или клавишей Enter.

Пользователей можно искать не только по номеру, но и по имени:

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

## Исходящие звонки

### Звонок кликом (click-to-call, c2c)

Для совершения исходящего звонка нужно нажать на номер телефона в карточке клиента.\
Откроется карточка звонка и придет звонок на AsterPhone - будет сразу же зеленая полоска, и звонок сразу же пойдет клиенту.

Также можно нажать на иконку телефона в каждом “деле” звонка в таймлайне и в заголовке самого контакта:

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

### Ввод номера с поиском для совершения исходящего

При вводе номера в поле поиска AsterPhone обратится в базу Битрикс24 и найдет всех пользователей и сущности (лиды, контакты, компании), у которых встречается введенный номер:

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

Имя - кликабельная ссылка, можно открыть прямо в данной вкладке.

Чтобы позвонить, можно выбрать не только пользователя/сущность, но и конкретный номер телефона (если их несколько) с помощью клавиш-стрелок на клавиатуре, либо кликом по номеру.

Можно выбрать верхний пункт “набор номера…”, тогда звонок начнется с “неизвестным контактом”.

Начать звонок можно кнопкой или клавишей Enter.

Искать можно не только по номеру, но и по имени:

\\

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

## Ошибки

### Не удалось подключиться

При неудачной попытке подключиться к серверу телефонии AsterPhone покажет всплывающее окно с ошибкой (code 1006).

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

В этом случае:

1. Проверьте, что в браузере выключен VPN.
2. Сбросьте кэш и куки. Перезагрузите страницу.
3. Если подключиться по-прежнему не удалось, обратитесь к администратору телефонии.

### Сброс состояния

На случай возникновения ошибок в работе AsterPhone на этапе отладки и тестирования предусмотрена кнопка сброса текущего состояния.\
В других вкладках нужно будет сохранить данные и обновить страницу

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

## Удаление приложения

Администрирование - Marketplace - Установленные решения - Удалить

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

Для удаления приложения из базы данных:<br>

1. Настройки -> Инструменты -> SQL запрос
2. Выполнить запросы(можно сразу все):

```sql
drop table itgrix_license;
drop table itgrix_user;
DELETE from b_option where MODULE_ID='itgro.asterphone';
select * from b_option where MODULE_ID='itgro.asterphone';
```

<figure><img src="/files/7V8Vjioiw4ATq1x4a1cX" alt=""><figcaption></figcaption></figure>