IQ4

1. Описание

iQChannels содержит ряд инструментов, которые позволяют производить тесную интеграцию с CRM и другими с учетными системами. Инструменты платформы позволяют выстраивать как одностороннюю и двухстороннюю интеграцию.

Интеграция с CRM может быть выполнена в части:

1. Построение единого окна - встраивание виджета в CRM для общения с клиентами в режиме единого окна из CRM.

2. Базового обмена данными - идентификация, авторизация, получение карточки и продуктов клиента, получение продуктовой витрины, и получение событий клиента (открытия обращений, отправка сообщений и прочее).

3. Полной интеграции - реализация собственного окна чата в CRM на основе внутреннего API платформы.

На схеме показана омниканальная работа платформы со всеми цифровыми клиентскими каналами в режиме единого окна в CRM. Кроме встраивания виджета, подключено несколько интеграционных API, отвечающих за:

идентификацию клиента
авторизацию и получение карточки клиента
получение продуктов клиента
получение продуктовой витрины
отправка событий клиента (открытия обращений, отправка сообщений и прочее)

2. Авторизация клиентов в CRM \ ДБО

Для того, чтобы в iQChannels операторы могли работать с авторизованными клиентами и видеть их данные, необходимо подключить авторизацию клиентов в ДБО или CRM. Идентификация клиентов и получение карточки из CRM, ДБО или любой другой системы реализовывается с помощью специального протокола авторизации клиентов Auth API.

Ознакомиться с протоколом авторизации можно в разделе Протокол авторизации клиентов.

3. Встраивание окна чата iQChannels в CRM

Для построение режима единого окна, в iQChannels реализован готовы виджет АРМ оператора, который можно встроить в CRM в двух вариантах. При необходимости можно использовать оба варианта в зависимости от контекста приложения.

3.1 Вариант №1 - Обычное встраивание (Приложение в приложении)

Данный вариант подразумевает минимальную связанность двух продуктов и при открытии чата, CRM нет необходимости знать об открытых обращениях клиентов.

Окно чата IQChannels встраивается как "мини-приложение" и при его инициализации вся работа происходит в нем.

Пример встраивания чата IQChannels в CRM:

...
    <!-- Код 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

3.2 Вариант №2 - Расширенное встраивание (Диалог в приложении)

В данном варианте подразумевается наличие более тесной интеграции, в которой либо iQChannels должен знать идентификаторы клиентов в CRM, либо CRM система должна знать идентификаторы клиентов в iQChannels. Для этого необходимо не только встроить виджет чата, но и подключить соответствующее API (см. раздел 4. Передача событий и других активностей). Все API для организации более тесной интеграции описана в следующих разделах данной статьи.

В данном режиме при инициализации чата iQChannels сразу будет открываться окно диалога с клиентом.

Пример встраивания чата IQChannels в CRM

...
    <!-- Код iFrame для встраивания на страницу -->
    <iframe src="https://iqchannels.iqstore.ru/" width="100%" height="700" id="iQChannels"></iframe>
...
    <!-- скрипт для работы с чатом -->
    <script>
        // с данным режимом сразу будет открываться окно диалога с клиентов при переходе на страницу.
        window.onload = function () {
            openChat();
        }  
        function openChat () { // Если требуется открыть диалог с клиентом
            const clientId = айди нужного клиента
            const ticketId = либо айди тикета
            const crmID = либо crmID клиента
            можно всё вместе
            const myIframe = document.getElementById('iQChannels');
            if (myIframe) {
                myIframe.contentWindow.postMessage({
                    'Type': 'open_iframe_ticket',
                    'OpenTicket': {
                        'ClientId': clientId,
                        'TicketId': ticketId,
                        'CRMID': crmID
                    }
                }, '*');
            }
        }

    </script>
...

Подробнее тут: PostMessage API

4. Идентификация клиентов в неавторизованных каналах

В платформе iQChannels реализован такой инструмент, как Search client API, который позволяет идентифицировать клиентов во внешних, по отношению к iQChannels, системам и получив их уникальный ключ выполнить авторизацию данного клиента с получением его карточки из внешней системы.

Подробнее в разделе: Search client API.

5. Передача событий и других активностей

В платформе iQChannels реализован такой инструмент, как Webhooks API, который позволяет внешним, по отношению к iQChannels, системам подписываться на события чата iQChannels. Webhooks API позволяет CRM, ДБО и другим внешним системам получать вызовы со стороны IQChannels на события в публичном API и быть в курсе о наличии открытых обращений, истории взаимодействия с клиентом, используемых каналах связи, сегментах обслуживания, о принявшем обращение операторе и другой информации, связанной с обслуживанием клиента.

Подробнее в разделе: Webhooks API.

6. Получение списка персональных менеджеров из CRM

iQChannels позволяет выделить и закрепить за клиентом персонального менеджера, который будет его обслуживать. Назначение персональных менеджеров можно выполнять как в ручном режиме, так и в автоматизированном режиме, получая данные из внешней системы CRM или ДБО. В автоматизированном режиме синхронизации, IQChannels периодически запрашивает список персональных менеджеров и их клиентов и обновляет соответствующие связи. параметры синхронизации настраиваются в разделе "Внешние системы" в каждом конкретном проекте (сегменте клиентов).

Подробнее тут: PersMgr Sync API.

7. Получение данных из внешних систем в сценарии чат-бота

В случаях когда чат-боту iQBot необходимо получить данные из внешней системы, в комплексе инструментов iQBot есть возможность конструировать интеграции с внешними системами. Такие интеграции позволят боту получать необходимую информацию из внешних источников онлайн в рамках выполняемого сценария обслуживания клиента.

Для предоставления документации по iQBot обратитесь в службу технической поддержки iQStore.

8. Построение сложных интеграции внешних систем с чатом

IQChannels построена на базе открытого API, который позволяет решать самые сложные задачи интеграции нескольких информационных систем.

Подробнее тут: Internal API

Page tree

Интеграция с CRM