===== Описание дополнительных модулей =====

  - Модуль **pt1c** предназначен для настроек на стороне АТС для связи с 1С. 
  - Модуль **fax**. Добавлен механизм заполнения информации об имени файла факса, в таблице истории звонков

<note important>**Внимание**! Модуль "**pt1c**" при инсталляции сформирует дополнительную таблицу истории звонков. Может потребоваться дополнительное дисковое пространство.</note>

<note warning>Панель телефонии может работать с Asterisk с версии 1.8 по 13 и 16 версией.\\
**Рекомендуем использовать версию 11.**</note> 
**Панель телефонии 1.4.26.26+ и 1.2.24.18+**

Скачайте и распакуйте ZIP архив, в нем находятся модули, это необходимо для дальнейшей настройки АТС.\\
[[https://files.miko.ru/s/IE5fhpwzohLjDwx|Скачать архив "release_2_11_3_96.zip"...]]\\
===== Установка модуля pt1c =====

<note warning>При использовании FreePBX 12, модуль "**FreePBX Framework**" должен быть не ниже **12.0.34** версии.\\ {{ :astpanel:ats:freepbx_framework.png?nolink |}}\\ \\ Узнать версию модуля можно, перейдя в интерфейс  **Admin** - **Module Admin**, найти модуль в списке и проверить версию. В подвале web-интерфейса также может быть указана версия framework. </note>

[[http://wiki.freepbx.org/display/F2/Download+and+Installing+Custom+Modules|Оригинал статьи]]

<note warning> Перед началом интеграции настоятельно рекомендуем делать **РЕЗЕРВНУЮ КОПИЮ** вашей конфигурации!</note>

Перейдите в интерфейс администрирования модулей FreePBX "**Admin**" - "**Module Admin**":
{{:doc:pluginsfreepbx:snimok_ehkrana_2013-03-27_v_13.36.52.png?nolink|}}

Выполните действие "**Upload nodules**":
{{:doc:pluginsfreepbx:snimok_ehkrana_2013-03-27_v_13.37.52.png?nolink|}}

Выберите файл расширения:
{{ :astpanel:ats:release_2_11_2_8.png?600 |}}

Загрузите файл, используя действие "**Upload**":
После подгрузки модуля перейти по гиперссылке **local module administration**
{{:doc:pluginsfreepbx:snimok_ehkrana_2013-03-27_v_13.43.34.png?nolink|}}

В разделе "**Setting**" выбрать "**Install**":
{{ :astpanel:ats:freepbx_administration.png?500 |}}

В нижнем правом углу выполните действие "**Process**". Подтвердите установку - "**Сonfirm**":
{{ :astpanel:ats:freepbx_administration_confirm.png?500 |}}

Отобразится окно статуса **pt1c installed successfully**:
{{ :astpanel:ats:freepbx_administration_status_install.png?400 |}}

Примените изменения - "**Apply config**":
{{:doc:pluginsfreepbx:snimok_ehkrana_2013-03-27_v_13.50.42.png?nolink|}}
===== Manager Asterisk =====

Необходимо перейти в интерфейс модуля **[[http://wiki.freepbx.org/display/F2/Asterisk+Managers+User+Guide | Asterisk Manager Users]]**
{{ :astpanel:ats:freepbx_administration_2.png?nolink&500 | Asterisk Manager Users}}

Указать имя / пароль менеджера, указать разрешенные / запрещенные сети:
{{ :astpanel:ats:freepbx_administration_managerapi.png?500 |}}

В примере параметр **"Разрешены" (Permit)** установлен в значение **0.0.0.0/0.0.0.0** (разрешено подключаться под всеми сетевыми адресами).\\
Установите значения привилегий:
{{ :astpanel:ats:freepbx:manager_privileg.png?nolink&200 |}}
<note warning>**Не устанавливайте полные права** для учетной записи! Больше - не значит лучше!</note>

<note warning>Современные версии FreePBX используют Asterisk 11+. Для этих версий asterisk необходимы выполнить дополнительные настройки manager AMI. 
  - Подключитесь к ПК c АТС по ssh 
  - Создайте новый файл <code>touch /etc/asterisk/manager_custom_level_2.conf</code>
  - Предоставьте права доступа на чтение: <code>chmod +r /etc/asterisk/manager_custom_level_2.conf</code>
  - В файл manager_custom_level_2.conf добавьте дополнительные опции для менеджера **1cami** <code>[1cami](+) 
;;; Дополнительные опции для ASTERISK 11+ ;;; Начало ;;;;
eventfilter=!Event: Newexten
eventfilter=!Event: DeviceStateChange
eventfilter=!Event: NewConnectedLine
eventfilter=!Event: Newchannel
eventfilter=!Event: SoftHangupRequest
eventfilter=!Event: HangupRequest
eventfilter=!Event: BridgeDestroy
eventfilter=!Event: BridgeCreate
eventfilter=!Event: BridgeMerge
eventfilter=!Event: MusicOnHoldStop
eventfilter=!Event: MusicOnHoldStart
eventfilter=!Event: NewCallerid
eventfilter=!Event: LocalBridge
eventfilter=!Event: Unhold
eventfilter=!Event: Hold
eventfilter=!Event: AttendedTransfer
;;; Дополнительные опции для ASTERISK 11+ ;;; Конец ;;;;</code>
  - Чтобы изменения вступили в силу выполните команду: <code>asterisk -rx'manager reload'</code>
 
</note>
===== Прочие пакеты =====

Для активации возможности перехвата на ответственного установите модуль "**core**". 

<note important>Плагин следует выбрать для вашей версии FreePBX.\\ В архиве предложено несколько версий **core**:
  * **core-2.8.1.2.tgz**
  * **core-2.11.0.34.tgz**
  * **core-12.0.20.tgz**
  * **...**
Номер версии указан после строки "**core-**".\\
пример: 12.0.20 - FreePBX 12 версии.\\
пример: 2.8.1.2 - FreePBX 2.8 версии.\\

**Номер версии не должен быть "младше"**, чем номер версии уже установленного модуля.
</note> 

<note tip>Если необходимо в истории факсов видеть входящие факсимильные сообщения - установите нашу версию модуля  "**fax**".</note> 

===== Настройка ====

Для настройки плагина следует перейти **"Settings" - "Asterisk AJAM Settings (PT1C)"**:

{{ :astpanel:ats:freepbx_administration_pt1c_settings.png?600 | Активация AJAM интерфейса}}

Отправьте настройки на сервер - "**Submit Changes**".\\
Примените изменения - "**Apply config**".

Необходимо включить использование "Asterisk Builtin mini-HTTP server".\\
Перейдите "**Settings**" - "**Advanced Settings**":
{{ :astpanel:ats:asterisk_http_server.png?600 |}}
  * "**Enable the mini-HTTP Server**" - установите значение "**true**"
  * "**Enable Static Content**" - установите в значение "**true**"
  * "**HTTP Prefix**" - установите значение "**asterisk**"

Примените изменения - "**Apply config**".
===== Проверка =====

Идем в браузере по адресу:\\
http://ipadress_asteriska:8088/asterisk/rawman?action=login&username=1cami&secret=PASSWORD1cami

Если в качестве результата получим строку:
<code>Response: Success
Message: Authentication accepted
</code>
Значит со стороны Asterisk все настроено правильно.

Не забудьте открыть на фаерволе порт 4443 или 8088 чтобы интерфейс ajam был доступен из вне.

Например для iptables под управлением CENTOS это делается добавлением строчки в файл /etc/sysconfig/iptables 
<code>
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp   --dport 8088 -j ACCEPT
</code>