====== Askozia MIKO Edition ======
Эта версия сборки предназначена для интеграции с системами на базе 1С:Предприятие. Содержит набор дополнительных программных пакетов и скриптов, позволяющих взаимодействовать с 1С по средствам программ **[[http://www.telefon1c.ru/asterisk/|Панель телефонии Asterisk]]**.

===== Интерфейсы =====
Все “**интерфейсы**” представлены в виде приложений плана набора АТС, либо в виде обычных PHP скриптов, опубликованных на WEB сервере Askozia.

Схема взаимодействия с приложениями плана набора

==== Инструменты и продукты ====
  * **[[http://www.telefon1c.ru/asterisk/|Панель телефонии Asterisk]]** - разработана на базе SDK и использует интерфейсы и сервисы Askozia для взаимодействия с АТС.
  * **[[http://www.telefon1c.ru/sip/|SIP Софтфон для 1С]]** - может взаимодействовать с Askozia по SIP протоколу.

==== Схема взаимодействия с приложениями плана набора ====

На АТС реализованы дополнительные "Простые" и "PHP" приложения плана набора с номерами формата **10000ХХХ**. Взаимодействие 1С с АТС Askozia осуществляется средствами   “**SDK: Компонента связи 1C и Asterisk**” (далее SDK). Порядок взаимодействия 1С с приложением следующий:
  - Авторизация на сервере АТС (метод login).
  - Выполнение команды originate на номер приложения 10000ХХХ с передачей параметров запроса.
  - Получение ответа в виде внешних событий в 1С.

=== Перечень реализованных приложений ===
  * [[https://github.com/boffart/Askozia_PHP_AGI_Apps/blob/master/10000104_1C_interception|10000104]] - перехват на ответственного. "Простое" приложение.
  * [[https://github.com/boffart/Askozia_PHP_AGI_Apps/blob/master/1C_get_context.php|10000109]] - получение контекста для звонков.
  * [[https://github.com/boffart/Askozia_PHP_AGI_Apps/blob/master/1C_SetupEnv.php|10000111]] - получение настроек с АТС
  * [[https://github.com/boffart/Askozia_PHP_AGI_Apps/blob/master/1C_SetStatus.php|10000222]] - установка / получение статусов пользователей.
  * [[https://github.com/boffart/Askozia_PHP_AGI_Apps/blob/master/1C_SendFax.php|10000333]]  - приложение для инициации отправки факса
  * [[https://github.com/boffart/Askozia_PHP_AGI_Apps/blob/master/1C_HistoryFax.php|10000444]] - получение таблицы истории факсов за период
  * [[https://github.com/boffart/Askozia_PHP_AGI_Apps/blob/master/1С_CDR.php|10000555]] - получение истории звонков за период, по конкретным номерам
  * [[https://github.com/boffart/Askozia_PHP_AGI_Apps/blob/master/1C_Download.php|10000666]] - подготовка файла факса, записи разговора к скачиванию (публикация на в доступном каталоге WEB сервера).
  * [[https://github.com/boffart/Askozia_PHP_AGI_Apps/blob/master/1С_Playback.php|10000777]]  - приложение для старта воспроизведения записи разговорам. Если файл записи найден, будет произведен обратный звонок на номер пользователя АТС, при поднятии трубки будет проиграна запись.
==== Дополнительные функции сервера АТС ====

Все сервисы расположены по пути "http://HOST:PORT/cfe/wallboard/1c/"\\
В случае активации CTI модуля для Askozia следует использовать PORT = **23600**, если модуль не активирован, то PORT = **80**.

=== Сервис для синхронизации истории звонков ===
Позволяет получить заданное число записей таблицы истории звонков, начиная с конкретного порядкового номера. Общий формат запроса:

**http://HOST:PORT/cfe/wallboard/1c/cdr_xml.php?limit=XXX&offset=YYY ** 
  * ХХХ - количество пакетов (должно быть меньше 500).
  * YYY - смещение выборки.
  * HOST - адрес сервера АТС.

Используя сервис возможно реализовать периодическую синхронизацию таблицы истории звонков в 1С (к примеру записей регистра сведений) и таблицы истории АТС. Этот подход рекомендуется использовать как альтернативу приложений 10000444 и 10000555 в случаях:

  * большие объемы таблицы истории звонков (CDR таблица Asterisk, хранится в Sqlite3 базе).
  * если необходимы расширенные отчеты по звонкам, к примру с использованием СКД.

=== Сервис загрузки файлов ===

Предназначен для загрузки файлов факсимильных сообщений на АТС  и их подготовке к отправке. Формат запроса:

**http://HOST:PORT/cfe/wallboard/1c/upload.php**
  * HOST - адрес сервера АТС
Формат поддерживаемых файлов **TIF** и **PDF**.

=== Сервис скачивания файлов ===
Предназначен для скачивания записей телефонных разговоров и факсимильных сообщений. Формат запроса:

**http://HOST:PORT/cfe/wallboard/1c/download.php?type=TYPE&view=FILENAME**
  * HOST - адрес сервера АТС
  * TYPE - тип загружаемого файла (может принимать значения FAX, Records)
  * FILENAME - имя файла
==== Прочие возможности интеграции ====


  * [[http://habrahabr.ru/post/166935/|Интеграция 1С:CRM и Asterisk с помощью PHP-AGI и веб-сервисов 1C]]. В статье описан вариант взаимодействия Askozia  c SOAP web-сервисом.

===== Документация и инструкции =====
 
  * [[http://www.telefon1c.ru/blogs/askozia/installing-askozia-on-vmware-player/| Набор инструкций по быстрому старту]] 
  * [[http://qa.askozia.ru/|Сервис “Вопрос - ответ”]]
  * [[http://www.telefon1c.ru/forum/forum24/|Форум]]

===== Обновление dialplan =====

  * [[handbook:obnovlenieto16|Обновление с 2.1.6v4 до 2.1.6v5 ]]
  * [[handbook:obnovlenieto22|Обновление с 2.1 до 2.2.2 ]]
  * [[handbook:obnovlenie22to1005|Обновление с 2.2 до плана набора версии 1.0.0.5 ]]
  * [[handbook:obnovlenie222to228|Обновление с 2.2.2 до 2.2.8 ]]
  * [[handbook:obnovlenie228to302|Обновление с 2.2.8 до 3.0.2 ]]
  * **[[handbook:obnovlenieo302to401|Обновление с 3.0.2 до 4.0.1 (dialplan 1.0.0.6)]]**