Интеграция с ДБО
Описание
iQChannels содержит ряд инструментов, которые позволяют производить тесную интеграцию с системами ДБО.
Интеграция с ДБО может быть выполнена в части встраивания чата в:
-
Интернет-банкинг — встраивание виджета в неавторизованную и авторизованную зону Интернет-банкинга для взаимодействия с клиентами.
-
Мобильный банкинг — встраивание SDK в нативные мобильные приложения или виджета в гибридные мобильные приложения.
-
Рабочее место оператора — опциональное встраивание виджета рабочего места оператора в консоль управления системой ДБО.
На схеме показана омниканальная работа платформы со всеми цифровыми клиентскими каналами в режиме единого окна в CRM. Главные компоненты ДБО и интеграционные инструменты iQChannels выделены цветом.
Информация о способах интеграции с CRM описана в разделе «Интеграция с CRM».
Встраивание в интернет-банкинг
Виджет для сайта / интернет-банкинга и инструкция по установке и интеграции расположены здесь:
- SDK для Web: https://github.com/iqstore/iqchannels-widget
Встраивание в мобильный банкинг
SDK для нативных мобильных приложений и инструкция по установке и интеграции расположены здесь:
- SDK для iOS: https://github.com/iqstore/iqchannels-swift
- SDK для Android: https://github.com/iqstore/iqchannels-kotlin
Авторизация клиентов в ДБО
Чтобы в iQChannels операторы могли работать с авторизованными клиентами и видеть их данные, необходимо подключить авторизацию клиентов в ДБО. Идентификация клиентов и получение карточки из ДБО (или любой другой системы) реализуется с помощью специального протокола авторизации клиентов Auth API.
Ознакомиться с протоколом авторизации можно в разделе Протокол авторизации клиентов.
Встраивание окна чата iQChannels в консоль администратора ДБО
Для построения режима единого окна в iQChannels реализован готовый виджет АРМ оператора, который можно встроить в консоль администратора ДБО в различных вариантах. При необходимости можно использовать несколько вариантов в зависимости от контекста приложения.
Вариант №1 — Приложение чата в одном из разделов ДБО
Данный вариант подразумевает минимальную связанность двух продуктов: при открытии чата системе ДБО нет необходимости знать об открытых обращениях клиентов.
Окно чата iQChannels встраивается как мини-приложение, и при его инициализации вся работа происходит в нем. При этом из окна рабочего места оператора iQChannels остается возможность открыть карточку клиента в ДБО. В этом случае ДБО получит событие open_client и сможет загрузить карточку клиента.
Пример встраивания чата iQChannels в консоль администратора ДБО:
...
<!-- Код iFrame для встраивания на страницу -->
<iframe src="https://iqchannels.iqstore.ru/" width="100%" height="700" id="iQChannels"></iframe>
...
<!-- скрипт для работы с чатом -->
<script>
function openDialog(){
var myIframe = document.getElementById("iQChannels");
if (myIframe){
myIframe.contentWindow.postMessage({
"Type": "write_to_client",
"WriteToClient": {
"Search": "Строка для поиска клиента по имени, ИНН, ID в ДБО или CRM"
}
}, '*');
}
}
</script>
...
<button onclick="openDialog()">Открыть поиск</button>
...
Подробнее о встраивании и о возможных событиях для ДБО в разделе PostMessage API
Вариант №2 — Плавающее приложение чата в приложении ДБО
Данный вариант встраивания отличается от варианта №1 тем, что iframe, в который встраивается чат, является плавающим окном и может быть свернут или не закрывается при переходах между разделами ДБО.
Реализация плавающих свойств iframe и механизма сворачивания и изменения размеров чата лежит на стороне ДБО.
В данном варианте ДБО подписывается на дополнительные события iQChannels, для реализации автоматического раскрытия и закрытия карточки клиента в родительском окне ДБО при открытии / закрытии обращения в чате (open_client_from_ticket, close_client_from_ticket).
Подробнее о встраивании и о возможных событиях для ДБО в разделе PostMessage API
Вариант №3 — Чат-диалог в карточке клиента ДБО
В данном варианте подразумевается, что чат можно будет открыть непосредственно из карточки клиента в ДБО. В этом случае iQChannels должен знать идентификаторы клиентов в ДБО, либо система ДБО должна знать идентификаторы клиентов в iQChannels. Для этого необходимо не только встроить виджет чата, но и подключить соответствующее API (см. раздел Передача событий и других активностей). Все API для организации более тесной интеграции описаны в следующих разделах.
Диалог открывается сообщением open_iframe_ticket по одному из идентификаторов. Применяется приоритет: сначала TicketId, при его отсутствии — ClientId, при его отсутствии — CrmClientId (по последнему обращению клиента; если обращений нет, создается новое).
В данном режиме при инициализации чата iQChannels сразу будет открываться окно диалога с клиентом.
Пример встраивания чата iQChannels в ДБО
...
<!-- Код iFrame для встраивания на страницу -->
<iframe src="https://iqchannels.iqstore.ru/" width="100%" height="700" id="iQChannels"></iframe>
...
<!-- скрипт для работы с чатом -->
<script>
// с данным режимом сразу будет открываться окно диалога с клиентом при переходе на страницу.
window.onload = function () {
openChat();
}
function openChat () { // Если требуется открыть диалог с клиентом
const clientId = 123; // id клиента в iQChannels (можно опустить, если передается TicketId или CrmClientId)
const ticketId = 456; // id обращения в iQChannels (при наличии)
const crmClientId = "00234"; // id клиента в CRM (если известен)
const myIframe = document.getElementById('iQChannels');
if (myIframe) {
myIframe.contentWindow.postMessage({
'Type': 'open_iframe_ticket',
'OpenTicket': {
'ClientId': clientId,
'TicketId': ticketId,
'CrmClientId': crmClientId
}
}, '*');
}
}
</script>
...
Подробнее в разделе PostMessage API
Передача событий и других активностей
В платформе iQChannels реализован такой инструмент, как Webhooks API, который позволяет внешним, по отношению к iQChannels, системам подписываться на события чата iQChannels. Webhooks API позволяет ДБО и другим внешним системам получать вызовы со стороны iQChannels на события в публичном API и быть в курсе о наличии открытых обращений, истории взаимодействия с клиентом, используемых каналах связи, сегментах обслуживания, о принявшем обращение операторе и другой информации, связанной с обслуживанием клиента.
Подробнее в разделе Webhooks API.
Получение данных из ДБО и других внешних систем в сценарии чат-бота
В случаях когда чат-боту iQBot необходимо получить данные из внешней системы, в комплексе инструментов iQBot есть возможность конструировать интеграции с внешними системами. Такие интеграции позволят боту получать необходимую информацию из внешних источников онлайн в рамках выполняемого сценария обслуживания клиента.
Для предоставления документации по iQBot обратитесь в службу технической поддержки iQStore.