Web-интеграция с CRM

Материал из Oktell
Перейти к: навигация, поиск

Подробно c механизмом интеграции по web-socket протоколу с web-системами и интерфейсами протокола можно ознакомиться в статье «Интеграции. Web-Socket». Поддерживается работа только с одной web-crm системой одновременно в соответствии с настройками, описанными в текущем разделе.


Способ соединения с Web-Socket CRM.

Позволяет выбрать направление подключения. Если Oktell подсоединяется к CRM, то веб-сервер CRM должен ожидать подключения и websock-рукопожатия согласно протоколу, если наоборот, то Oktell ждет подключения на указанном порте, ожидает инициации рукопожатия от CRM. Ожидается, что в случае потери связи между серверами восстановлением канала занимается именно инициатор. При организации подключения из Oktell позволяет выбрать один из протоколов WebSocket, включая определенную RFC6455 версию 13. Также здесь возможно активировать режим клиентских подключений к серверу Oktell по протоколу web-socket. В этом случае сервер позволяет одновременно существовать нескольким подключениям, причем каждое из них представляет отдельного пользователя и несколько разных подключений могут представлять одного и того же пользователя (разные вкладки браузера).


Адрес web-socket сервера Порт web-socket сервера

В случае, если Oktell является инициатором подключения, задают адрес и порт слушателя web-socket подключений со стороны CRM. Если настройка меняется в ходе работы, производится разрыв текущего соединения и организация нового. При наладке глобальных серверов CRM, способных обслуживать несколько различных серверов Oktell, следует иметь в виду, что каждому серверу Oktell нужен независимый web-socket-сервер на стороне CRM, чтобы не пересекались потоки данных. Для этого следует настраивать разные серверы или разные экземпляры служб, слушающих разные порты. Различий на этапе самого подключения между разными октеллами нет, хотя после стандартного websock-рукопожатия серверы обмениваются данными друг о друге.


URL web-сервера

Устанавливает адрес веб-сервера CRM, способного заниматься обработкой части запросов. В рамках интерфейса взаимодействия с WebCRM между системами происходит обмен данными о поддерживаемых динамических методах (подробно в «Интеграции. Web-Socket»). В рамках описания динамического метода CRM-система может декларировать вызов не по web-socket каналу, а отдельным подключением и http-запросом. Как правило это делается для методов, возвращающих большой объем данных и вызываемых не слишком часто. Вызов таких методов настраивается в сценариях с помощью компонента «Действие/карточка в Plugin или WebCRM»%%% и производится на указанный здесь URL.


Порт слушателя подключений Для случая, когда CRM является инициатором web-socket подключения, она должна производить подключение к серверу Oktell на указанный здесь порт.


Название протокола Для предварительной фильтрации и некой строгости возможно указание (или строгое ожидание) в websock-рукопожатии четкого названия протокола. К названию протокола также добавляется формат (json/xml) и версия протокола.


Формат обмена данными JSON/XML. Способ упаковки пересылаемых данных в текстовый вид.