====== Принцип работы PINConnector ======

PINConnector построен в виде отдельного приложения, обменивающегося данными как с Asterisk так и с VtigerCRM. Обмен данными с Asterisk реализован через интерфейс AMI. Обмен с vTiger происходит через модуль Звонки, имеющий нужный интерфейс.

==== Обмен данными с Asterisk ====
----
PINConnector постоянно получает данные от Asterisk с помощью AMI. Его задача — отфильтровать те события которые должны найти отражение в CRM. Коннектор сохраняет эти данные в своей базе данных. В CRM информация уходит в форме уже доступной для использования модулем Звонки.

  * **Звонок** \\ Поступлению звонка обычно соответствует событие DialBegin. \\ Окончание звонка — событие HangUp. Подробные данные о звонке, в том числе ссылка на запись разговора передаются в событии CDR.
  * **Переадресация звонка** \\ Если пользователь телефонии перенаправляет звонок другому пользователю с помощью комбинации клавиш на телефоне, либо осуществляется перевод звонка по FollowMe, коннектор получает и фиксирует эти данные.
  * **Клиент повесил трубку не дождавшись перевода на оператора** \\ В этом случае создается звонок в статусе Пропущен, хотя события DialBegin не было.
  * **Запрос данных из CRM** \\ Для перенаправления звонка на менеджера, который отвечает за звонящего клиента, можно использовать AGI запрос из диалплана к коннектору. Коннектор имеет метод для определения внутреннего номера ответственного пользователя.

==== Обмен данными с vTiger ====
----
  * **Проверка доступности** \\ При открытии страницы Настройки модуля Звонки автоматически осуществляется проверка PINConnector командой **connectorurl.com:port/ping** \\ Статус проверки выводится на экран.
  * **Звонок по нажатию на ссылку (Click-to-call)** \\ Когда пользователь CRM нажимает на номер телефона генерируется событие инициации вызова. Телефон привязанный к пользователю начинает звонить. После того как он снимет трубку начинается звонок клиенту.
  * **Прослушивание записи разговора** \\ Для ускорения работы и минимизации нагрузки на vTiger записи звонка пользователи CRM получают от PINConnector. Он в свою очередь проверяет в своей базе по ID звонка путь к файлу с записью разговора и отправляет пользователю.
  * **Перевод звонка из vTige** \\ Из всплывающей карточки, появляющейся при входящем вызове менеджер имеет возможность перевести звонок на другой номер. При этом модуль звонки отправляет в PINConnector запрос о переводе звонка.