Web-интеграция с CRM — различия между версиями
м (Oktell Support переименовал страницу Интеграция с Web-Socket CRM в Web-интеграция с CRM) |
|
(нет различий)
|
Версия 09:24, 19 декабря 2014
Техническая документация / Администрирование / Общие Настройки / Системные настройки / Интеграция с Web-Socket CRM
Связь с CRM позволяет:
- Использовать динамический функционал и данные CRM в сценариях Oktell;
- Предоставлять серверу CRM доступ к сервисным функциям Oktell;
- Снабжать CRM и ее пользователей информацией о событиях, а также функционалом, аналогичным клиентскому приложению Oktell;
- Инициировать открытие и закрытие форм у пользователей CRM, связанных с различными событиями (например поступление звонка).
Связь Oktell с CRM может осуществляться по транспортному протоколу websocket (подключение может осуществляться в любом направлении) и по протоколу http/https (подключение осуществляется от Oktell к CRM).
Все взаимодействие между серверами Oktell и CRM описывается «интеграционным протоколом Web-Socket».
В случае связи по HTTP/HTTPS передаваемые данные упаковываются в base64 и передаются в качестве значения переменной data POST-запросом; ожидается, что ответ CRM содержит неупакованные данные в том же формате. Подключения и обмен http-запросом и ответом осуществляются время от времени по необходимости.
В случае связи по WebSocket в соответствии с интеграционным протоколом Web-Socket CRM может быть подключена
- Способом 1 - по единому серверному каналу, обслуживающему и межсерверное взаимодействие, и клиент-серверное взаимодействие. За связь с клиентами отвечает сама CRM, выступая туннелем. Канал постоянно поддерживается, при разрыве восстанавливается.
- Комбинацией способа 1 и способа 2 - связь между серверами по одному каналу, а связь клиентов CRM с сервером Oktell непосредственно по websocket-каналу, минуя сервер CRM. При этом в качестве клиентского модуля связи может использоваться javascript-библиотека Oktell.js. Канал между серверами точно также постоянно поддерживается и восстанавливается при разрыве, каналы между клиентами и сервером точно также поддерживаются сервером но управляются клиентами. При этом один клиент может быть залогинен в нескольких подключениях (поддержка нескольких вкладок в браузере).
Поддерживается работа только с одной web-crm системой одновременно в соответствии с настройками, описанными в текущем разделе.
Способ соединения с сервером CRM
Позволяет выбрать направление подключения, транспортный протокол и уровень защиты.
- Oktell к CRM (HTTP). Oktell подсоединяется к серверу CRM по незащищенному каналу всякий раз по необходимости. Обменивается с CRM служебными сведениями (представляется, ждет представления, выясняет поддерживаемые динамические методы и формы), исполняет ориентированные к серверу динамические методы.
- Oktell к CRM (HTTPS). То же самое по защищенному каналу (TLS).
- Oktell к CRM (WebSocket). Oktell подсоединяется к CRM по незащищенному каналу используя транспортный протокол websocket; веб-сервер CRM должен ожидать подключения и websocket-рукопожатия согласно выбранной ниже в настройках версии протокола.
- Oktell к CRM (WebSocketSecure). То же самое по защищенному каналу (TLS).
- CRM к Oktell (WebSocket). Oktell ждет подключения на указанном порте-слушателе незащищенных соединений, ожидает инициации websocket-рукопожатия от CRM.
- CRM к Oktell (WebSocketSecure). То же самое по защищенному каналу (TLS). В этом случае системе необходим серверный сертификат X.509 с private ключом для организации TLS канала.
В случае использования постоянного websocket соединения ожидается, что в случае потери связи между серверами восстановлением канала занимается именно инициатор.
URL CRM-сервера
Доступно только при настройке способа соединения Oktell к серверу CRM по протоколу HTTP или HTTPS.
Полный URL для организации HTTP или HTTPS подключений к серверу CRM. При необходимости следует указать порт. Данные передаются POST-запросом на указанный URL в переменной data.
Адрес:порт CRM-сервера
Доступно только при настройке способа соединения Oktell к серверу CRM по протоколу WebSocket (защищенный или незащищенный канал).
По указанному адресу осуществляется подключение, которое переводится в WebSocket и настраивается на работу по интеграционному протоколу. Данные передаются независимыми сообщениями в выбранном ниже формате.
Версия протокола WebSocket
Доступно для выбранного режима подключения из Oktell к CRM по WebSocket.
Предоставляет на выбор версию транспортного протокола WebSocket. По умолчанию v13 (RFC 6455).
Порт WebSocket Oktell для CRM
Доступно для выбранного режима подключения из CRM к Oktell. Определяет порт слушателя подключения от CRM. Соответственно CRM должна производить подключение именно на указанный здесь порт. Должен быть отличным от других портов, используемых системой, и не занятым другими приложениями и службами.
Авторизация
Доступно для выбранного режима подключения из CRM к Oktell.
Способ прохождения авторизации (нет, базовый или дайджест).
Здесь следует отметить, что на текущий момент документация по протоколу WebSocket не определяет для сервера возможность в рамках рукопожатия отвечать отличным от "101 Switching Protocols" способом, несмотря на HTTP формат. Поэтому, если в CRM для организации WebSocket транспорта используется сторонние библиотеки, авторизация в Oktell должна быть отключена.
Логин:пароль для базовой авторизации
Использует значения для прохождения базовой авторизации на CRM, или требования прохождения авторизации от CRM.
Формат обмена данными
Доступно для выбранного режима подключения из Oktell к CRM.
JSON/XML. Способ упаковки пересылаемых данных в текстовый вид.
В рамках подключения ожидается, что в названии протокола (заголовок в запросе на рукопожатие WebSocket) будет содержаться слово json или xml. В противном случае сервер отказывает в обработке всех сообщений, поступающих по установившемуся каналу. При подключении от Oktell к CRM по HTTP формат указывается в переменной POST-запроса format.