~~NOTOC~~
====== Интеграция с FreePBX ======

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

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

<note warning>На сегодняшний момент поддерживается только FreePBX 15 (Asterisk 16)</note>

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

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

===== Шаг 1. Подготовьте АТС =====
Для интеграции FreePBX с 1С необходимо установить модуль "Панель телефонии 2.0 для FreePBX". В настройках модуля предлагается выбрать [[nightbird:connection-modes|один из режимов соединения с 1С]]. На текущем шаге настройку соединения можно пропустить и вернутся к ней позже.

Подробнее: [[nightbird:prepare-freepbx|Подготовка FreePBX]]

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

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

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

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

Далее нужно вернутся к настройке модуля расширения для АТС и установить соединение с 1С.

=== Можно не настраивать соединение с 1С, если ===
  * не планируется использовать приложение панели телефонии;
  * работа с 1С выполняется только через тонкий клиент для ОС Windows (в этом случае канал передачи событий должен быть установлен в значение "Внешняя компонента").

По завершению работы мастера проверьте, какие настройки подключения были установлены: //Телефония->Настройки подсистемы->Параметры подключения->Расширенные настройки//.

Если канал передачи контактных данных установлен в значение "Long-poll соединение", то дополнительная настройка модуля расширения не требуется. Перейдите в настройки регламентных заданий и убедитесь, что задания из раздела "Онлайн обмен данными" запущены.

Если канал передачи событий или канал передачи контактных данных установлен в значение "Веб-сервис", то информационная база должна быть опубликована на веб сервере Apache или IIS, а также [[nightbird:prepare-web-service|опубликован веб-сервис ПТ20_ПровайдерAPI]].

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

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

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