# Панель телефонии Oktell

Панель телефонии Oktell — дополнительный платный модуль.

## Телефон и номерной план

В приложение Бипиум встроена панель телефонии Oktell. Она показывает внутренний номерной план и позволяет вести разговоры из браузера: совершать внутренние и внешние звонки, переключать вызовы, организовывать конференции.

При первом использовании панели сотрудник авторизуется в ней: указывает адрес сервера Oktell и учетные данные. Адрес сервера — это доменное имя компьютера, с установленным серверным приложением Oktell. Например, oktell.mycompany.ru

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LACZmmM2xUWbZxyRr4s%2F-LRMSKLVm7YauG0K0toJ%2F-LRMSX_rrWdZFWVkaeHI%2Foktell_panel_numberlist.jpg?alt=media\&token=e1a2d53a-880c-4ca5-aeec-f986beb49ed4)

**ВАЖНО:** Согласно требованиям безопасности браузеров, для совершения звонков с сайта, соединение с сервером телефонии должно быть по защищенному каналу (HTTPS). Это значит, что для работы панели сервер Oktell должен иметь собственный домен и установленный SSL-сертификат. Инструкция по установке сертификата на сервер Oktell размещена в [википедии Oktell](http://wiki.oktell.ru).

## Кнопка «Позвонить»

При включенном модуле в карточке записи около поля типа «Телефон» появляется кнопка позвонить с дополнительными действиями: перевести звонок, поставить на удержание, пригласить в конференцию, сделать вызов громкой связью и другие.

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LACZmmM2xUWbZxyRr4s%2F-LRMXAhxHziuTB5iarxw%2F-LRMX-3igPrphVKOI6gT%2Fbutton.jpg?alt=media\&token=f0a37ab3-2691-44d9-a364-65947997091c)

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LACZmmM2xUWbZxyRr4s%2F-LRMXAhxHziuTB5iarxw%2F-LRMX1HHY6v9MrvLpHL0%2Fbutton_2.jpg?alt=media\&token=4276d76e-407b-4c89-910f-830fb356dc41)

## Открытие карточки во время звонка

Панель телефонии Oktell в Bpium позволяет ассоциировать звонок с данными в системе. Например, с карточкой клиента, партнёра, обращения, звонка и так далее. Со звонком может быть связано несколько карточек, сотрудник выбирает ту или иную в зависимости от потребности. Например, карточку клиента или создания нового обращения. Панель также позволяет открывать одну из карточек автоматически при поступлении звонка.

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LACZmmM2xUWbZxyRr4s%2F-LRMSKLVm7YauG0K0toJ%2F-LRMTHtB9P1EbBRQ6uW7%2Foktell_panel_popups.jpg?alt=media\&token=e152913c-6789-412b-bd39-043551cff30e)

Логика ассоциации настраивается в сценариях Oktell. При переводе звонка на сотрудника Oktell передаёт информацию о необходимых ассоциациях, Bpium отображает соответствующие кнопки открытия карточек и открывает одну из них при необходимости.

### Установка ассоциации в Oktell

Список ассоциированных действий устанавливается в сценарии Oktell через компонент «Статус объекта»:

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LACZmmM2xUWbZxyRr4s%2F-LRLBvTzmHiW90CScDCd%2F-LRLCqNVm7cfeZkCIxcA%2Foktell_panel_popups.jpg?alt=media\&token=7f44ee0f-7a89-4152-a188-15d548f40789)

* Действие — Установить
* Тип объекта — Линия
* Ключ линии — Номер линии
* Свойство/действие — Поле контента цепочки (заголовок)
* Значение — список ассоциированных действий в формате JSON

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LACZmmM2xUWbZxyRr4s%2F-LRMSKLVm7YauG0K0toJ%2F-LRMSo1HVrPo16PvxVcW%2Foktell_script_status_icon.jpg?alt=media\&token=eee981f4-76c0-4ba0-89cf-d7d8097e2efd)

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LACZmmM2xUWbZxyRr4s%2F-LRMSKLVm7YauG0K0toJ%2F-LRMSvXyvdYZFDF19OAV%2Foktell_script_status_params.jpg?alt=media\&token=7cb40600-62b9-411a-b416-ce2af7e99e0c)

### Формат значения списка действий

Используется формат JSON:

```javascript
{
   "actions": [
      {
         "type": "openRecord",
         "title": "Открыть ...",
         "catalogId": "3",
         "recordId": "1",
         "triggerImmediately": true,
         "number": "89012345678"
      },
      {
         "type": "createRecord",
         "title": "Создать ...",
         "catalogId": "3",
         "triggerOnAbonentClick": true
      }
   ]
}
```

#### Параметры

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LACZmmM2xUWbZxyRr4s%2F-LRLBvTzmHiW90CScDCd%2F-LRLDGK72LatYldkw8PU%2Foktell_script_status_params.jpg?alt=media\&token=f47f25b8-7965-455a-8a15-bb94b824418a)

* **actions\[]** — набор ассоциированных действий
* **action.type** — тип действия: openRecord — открыть карточку существующей записи, createRecord — открыть карточку новой записи
* **action.title** — название действия, отображаемое сотруднику
* **action.catalogId** — номер каталога
* **action.recordId** — номер записи в каталоге. Для действия createRecord не указывается
* **action.number** — номер абонента, с которым связано действие. Используется в конференциях и при переводах звонка (необязательный параметр)
* **action.triggerOnAbonentClick** — действие по умолчанию, если нажать на номер телефона в панели телефонии (необязательный параметр, по умолчанию false)
* **action.triggerImmediately** — автоматически открывать карточку при звонке (необязательный параметр, по умолчанию false)
