====== Интеграция с SIP телефонией ======

Данное руководство поможет запустить панель телефонии в работу как можно быстрее. Следуйте инструкциям шаг-за-шагом в том порядке, в котором они представлены.

<note>Данное руководство предполагает наличие навыков настройки АТС и работы с конфигуратором 1С. Для выполнения некоторых инструкций могут потребоваться права администратора.</note>

Данная инструкция предназначена для редакции 2.2, для предыдущих версий используйте [[nightbird:v21:get-started-sip|эту инструкцию]].

===== Задачи =====
  * [[nightbird:get-started-mango#shag_1_ustanovite_server_integracii|Шаг 1. Установите 
сервер интеграции]]
  * [[nightbird:get-started-mango#shag_2_ustanovite_rasshirenie_1s|Шаг 2. Установите расширение 1С]]
  * [[nightbird:get-started-mango#shag_3_nastrojte_1s_dlja_raboty_s_panelju_telefoniej|Шаг 3. Настройте 1С для работы с панелью телефонией]]
  * [[nightbird:get-started-mango#shag_4_ustanovite_panel_telefonii|Шаг 4. Установите панель телефонии]]

===== Шаг 1. Установите сервер интеграции =====
Чтобы использовать панель телефонии как SIP-софтфон с возможностью подключения к произвольному SIP-провайдеру, иметь доступ к телефонной книге 1С, а также совершать звонки из 1С в один клик, необходимо установить сервер интеграции и выполнить настройку SIP-прокси. 

Настройку подключения к 1С на данном шаге можно пропустить (оставьте значение "внешняя компонента") и вернутся к этому позже.

Подробнее: [[nightbird:prepare-sip-proxy|Настройка SIP-прокси]]

===== Шаг 2. Установите расширение 1С =====
Для установки расширения подсистемы телефонии используйте внешнюю обработку "Установщик.epf". Эта обработка может быть открыта в режиме 1С:Предприятие командой //Файл->Открыть// (Crtl+O) или добавлена в раздел "Дополнительные отчеты и обработки".

=== Для установки расширения ===
  - Запустите внешнюю обработку **Установщик.epf**.
  - **Выберите каталог** на диске, в котором расположены расширения для 1С. Убедитесь, что установщик смог подобрать расширение к конфигурации. В противном случае, выберите файл расширения самостоятельно.
  - Нажмите **Установить** и дождитесь установки расширения.
  - После добавления обработки **перезагрузите сеанс 1С**.

===== Шаг 3. Настройте 1С для работы с панелью телефонией =====
Перед началом работы требуется выполнить настройку подсистемы телефонии. Специальный мастер запускается сразу после  перезапуска сеанса 1C. Если мастер не запустился автоматически, откройте его в подсистеме //Телефония->Настройки->Мастер первоначальной настройки//.

=== Для настройки подсистемы ===
   - Из предложенных вариантов **выберите схему подключения**, которая наилучшим образом отражает расположение сервера 1С И АТС в сети. В расширенных настройках схемы будут установлены оптимальные настройки подключения исходя из сделанного выбора.
   - При работе через браузер или тонкий клиент для ОС Linux или ОС MacOS зарегистрируйте информационную базу в [[https://its.1c.ru/db/v8310doc/bookmark/dev/TI000001900|системе взаимодействия]].
   - На странице проверки связи выберите в качестве АТС - другой VOIP провайдер и **укажите IP адрес** компьютера, где установлен сервер интеграции.
   - Выберите (или создайте новый) вид контактный информации, который будет хранить внутренние номера телефонов пользователей.
   - Заполните внутренние номера пользователей, которые будут использовать телефонию.

Далее нужно вернутся к настройке сервера интеграции и установить соединение с 1С. По завершению работы мастера проверьте, какие настройки подключения были установлены: //Телефония->Настройки подсистемы->Параметры подключения->Расширенные настройки//.
  * Если канал передачи событий или канал передачи контактных данных установлен в значение "Long-poll соединение", то перейдите в настройки регламентных заданий и убедитесь, что задания из раздела "Онлайн обмен данными" запущены.
  * Если канал передачи событий или канал передачи контактных данных установлен в значение "Веб-сервис", то информационная база должна быть опубликована на веб сервере Apache или IIS, а также [[nightbird:prepare-web-service|опубликован веб-сервис ПТ20_ПровайдерAPI]].

=== После этого завершите настройку сервера интеграции ===
  - Проверьте и при необходимости измените [[nightbird:prepare-sip-proxy#shag_2nastrojte_sip-proksi_servis|настройки SIP-прокси]]. Используйте способ соединения канала передачи событий.
  - Добавьте сервис "1С:Предприятие" [[nightbird:prepare-sip-proxy#shag_3nastrojte_podkljuchenie_k_veb-servisu_1s|настройте его подключение]]. Используйте способ соединения канала передачи контактных данных.

===== Шаг 4. Установите панель телефонии =====
Панель телефонии - один из инструментов оператора, который помогает ему автоматизировать обработку вызовов. Программа может быть установлена каждому сотруднику индивидуально на его персональный компьютер или централизованно, если используется терминальный сервер.

Подробнее: [[nightbird:install-windows-workstation|Установка и запуск панели телефонии на рабочем месте сотрудника]]

----
== Полезные ссылки: ==
  * [[nightbird:connection-modes|Выбор режима соединения с 1С]]