# 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>


---

# 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.itgrix.ru/blog/asterphone-v-bitriks24.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.