Webim CRM postMessage Interface

Для обмена информацией между Webim, встроенным через iframe в другой веб-интерфейс (обычно это CRM), и этой CRM используется механизм window.postMessage(). postMessage позволит отправлять события между родительским окном CRM и встроенным в него РМО, а также обмениваться командами и осуществлять некоторые действия в CRM из РМО, не используя при этом интерфейс самой CRM.

Передаваемые события

При включении postMessage-интеграции Webim начинает передавать в родительское окно CRM-системы события типов, описанных в данном разделе.

Типы передаваемых событий (параметр event):

• newMessageAdded — добавление нового сообщения
• chatClosedByOperator — чат закрыт оператором
• visitorAuthorized — посетитель авторизовался
• visitorSelected — оператор открыл чат с данным посетителем в РМО
• notificationAdded — пришло уведомление
• notificationRemoved — уведомление удалено
• selectVisitorInSiebelButtonClick — оператор нажал кнопку Siebel в РМО

Для того, чтобы отправлять наборы данных CRM, на сервере Webim должны быть заданы соответствующие настройки, так как по умолчанию это запрещено из соображений безопасности. Если сервис Webim размещён на облачных серверах, то необходимо обращаться в техническую поддержку Webim. Если на ваших серверах, в конфигурации аккаунта в поле operator_iframe_allowed_parent_origin требуется добавить origin окна (окон), на которые требуется отправлять события.

В теории, РМО можно встроить в любую CRM, которая предусматривает возможность расширения своего интерфейса и вставки сторонних разработчиков в свой веб-интерфейс через iframe. На практике тестировалось встраивание через iframe в Siebel CRM.

Данные передаются в формате JSON.

Общий вид передаваемых данных:

{
    "source": "webim",
    "event": (тип события),
    "params": (дополнительные параметры)
}

Пример передаваемых данных:

{
	"source": "webim",
	"event": "chatClosedByOperator",
	"params": {
		"webimVisitorId": "c3fa5841c772895f8645b33ac784f694",
		"providedVisitorId": "12345",
		"chatId": 1024,
		"siebelId": "4-1GQJDL78",
		"channelId": "073afd9ccfee448dba19a5c974940bfc",
		"channelType": "vk",
		"channelUserId": "16248561",
		"channelUserName": "Пётр Петрович"
	}
}

Событие newMessageAdded

Событие вызывается, когда посетитель или оператор оставляет сообщение в чате.

Пример полей объекта params для события newMessageAdded:

{
    "webimVisitorId": "c3fa5841c772895f8645b33ac784f694",
    "providedVisitorId": "12345",
    "chatId": 483,
    "sessionId" : "c9905a4eab2a4148add9b1c8ac97ad7d",
    "kind": "visitor",
    "messageText": "Здравствуйте",
    "siebelId": "4-1GQDLH42"
}

Описание полей:

Событие chatClosedByOperator

Событие вызывается, когда чат был закрыт оператором.

Пример полей объекта params для события chatClosedByOperator (посетитель с канала общения ВКонтакте):

{
    "webimVisitorId": "c3fa5841c772895f8645b33ac784f694",
    "providedVisitorId": "12345",
    "chatId": 1024
    "siebelId": "4-1GQJDL78",
    "channelId": "073afd9ccfee448dba19a5c974940bfc",
    "channelType": "vk",
    "channelUserId": "16248561",
    "channelUserName": "Пётр Петрович"
}

Пример полей объекта params для события chatClosedByOperator (посетитель из неавторизованной зоны):

{
    "webimVisitorId": "c3fa5841c772895f8645b33ac784f694",
    "providedVisitorId": null,
    "chatId": 1024
    "siebelId": null,
    "channelId": null,
    "channelType": null,
    "channelUserId": null,
    "channelUserName": null
}

Описание полей:

Событие visitorAuthorized

Событие вызывается, когда посетитель авторизуется.

Общий вид:

{
    "old": { //данные до авторизации
        "webimVisitorId": "66b46319af05e55ac9fd34aa541e9eee",
        "providedVisitorId": null,
        "siebelId": null
    },
    "new": { //данные после авторизации
        "webimVisitorId": "52eed6ec3c12494a88e62e2ff636c2a9",
        "providedVisitorId": "7925",
        "siebelId": null
    }
}

Описание полей:

Событие visitorSelected

Событие вызывается, когда оператор открыл чат с посетителем в РМО.

Пример:

{
    "webimVisitorId": "c3fa5841c772895f8645b33ac784f694",
    "providedVisitorId": "12345",
    "chatId": 874,
    "sessionId" : "c9905a4eab2a4148add9b1c8ac97ad7d",
    "taskId": "20913584",
    "siebelId": "4-1GQJDL78"
}

Описание полей:

Событие notificationAdded

Событие вызывается, когда приходит уведомление.

Пример параметра params для события notificationAdded:

{
    "notification": {
        "id": "c9905a4eab2a4148add9b1c8ac97ad7d",
        "kind": "visitor",
        "text": "Посетитель покинул чат",
        "sessionId": "c3fa5841c772895f8645b33ac784f694"
    }
}

Описание полей параметра params:

Событие notificationRemoved

Событие вызывается, если уведомление было удалено (вне зависимости от того, было ли оно отсмотрено пользователем).

Пример параметра params для события notificationRemoved:

{
    "notification": {
        "id": "c9905a4eab2a4148add9b1c8ac97ad7d",
    }
}

Описание полей параметра params:

Событие selectVisitorInSiebelButtonClick

Событие вызывается, когда оператор нажимает кнопку Siebel в РМО.

Пример параметра params для события selectVisitorInSiebelButtonClick:

{
    "webimVisitorId": "e01baca71a28557b52b4e6038d12bcb8",
    "providedVisitorId": "12345",
    "visitorFields": {
        "id": "12345",
        "display_name": "Евгений",
        "phone": "+78123855337",
        "email": "abc@webim.ru"
    },
    "channelId": "142a171852f34530b4b66f7b0824812c",
    "channelType": "telegram",
    "channelUserId": "12578956"
}

Описание полей параметра params: