Подключение виджета

С виджетом можно взаимодействовать через глобальный объект: window.usedeskMessenger

Инициализируется (подключается к серверу, получает нужные данные) он автоматически. 

Методы виджета

window.usedeskMessenger.userIdentify(
{
	name: 'Rad test',
	email: 'rad@test.test',
	phone: '79222222666',
	additional_fields:
	[
    	{
			id: 3840, value: "текст"
		}, 
    	{
			id: 3841, value: "флажок"
		},
    	{
			id: 4704, value: "раскрывающийся список"
		},
    	[
			{
				id: 4011, value: "Вложенный список 1"
			},
			{
				id: 4012, value: "Вложенный список 2"
			},
			{
				id: 4013, value: "Вложенный список 3"
			}
		]
	]
}); 

Пример для получения token:

window.__usedeskWidgetInitedCallback = function() {            

  let token = window.usedeskMessenger.getChatToken();            

  console.log(token);        

}

Виджет может автоматически проинициализироваться, если в коде страницы к моменту подключения виджета уже будет существовать такой callback:

window.__widgetInitCallback = function (widget) {
	var expectedWidget = window.usedeskMessenger;
	expectedWidget.identify({ 
		email: 'bob@email.ru',
		phone: '+7911111111111',
		name: 'Bob Marly' 
		});
}

Если же вы не  используете первый способ (через window.__widgetInitCallback), то при использовании прямого вызова(ниже) будьте уверены в том, что пользователь не успеет кликнуть и открыть чат до того, как вам станут известны его данные и вы сможете прокинуть их в чат через прямой вызов identify.

Рекомендуем в таком случае скрывать и показывать виджет только после того, как станут известны данные пользователя и вы сможете их отправить в виджет.

window.usedeskMessenger.userIdentify({name: 'Dwight Schrute', email: 'dwight@mail.ru', phone: '79222222222'})

Инициализация сообщения от клиента

Метод для отправки сообщений в виджет с его открытием-созданием чата: window.usedeskMessenger.sendMessage

Методы виджета

Если необходимо указать почту, система будет ожидать пока не откроется окно чата и сразу отправит сообщение

window.usedeskMessenger.sendMessage({message:"Какой-то текст"})

Изменение дополнительных полей

Метод для изменения уже существующих полей в запросе window.usedeskMessenger.setAdditionalFields

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

window.usedeskMessenger.setAdditionalFields(
    [
        {
            id: 3840, value: "текст"
        },
        {
            id: 4704, value: "флажок"
        },
        [
            {
                id: 4011,value: "Вложенный список"
            }
        ]
    ]
)

Кнопки в виджете

В виджет можно выводить кнопки, формируя в сообщении определенные параметры.

Параметры

* обязательные поля 

В случае, если произошла ошибка в конфигурировании кнопки - кнопка и её настройки не будут отображены в виджете.

Цвет текста и фона кнопки конфигурируются на странице настроек виджета ("Цвет текста кнопки в сообщениях" и "Цвет фона кнопки в сообщениях"). При этом включены цвета по умолчанию, если параметры не заданы.

Пример: Возьми дробовик Винсент {{button:Возьми дробовик;https://usedesk.ru;blank;show}}

Идентификаторы элементов виджета

Для сбора статистики или кастомизации виджета можно обращаться к различным элементам виджета через их уникальные идентификаторы:

• Сама иконка виджета - uw-main-button
• Кнопка закрытия виджета - uw-main-button-close
• Кнопка закрытия окна чата при активном чате - uw-close-chat-button
• Кнопка "Задача завершена?" - uw-task-solved-button
• Кнопка отправки сообщения - uw-message-submit-button
• Кнопка вложения - uw-attachment-button
• Каждая из возможных кнопок каналов:
  • id: 'uw-button-facebook',
  • id: 'uw-button-telegram',
  • id: 'uw-button-ok',
  • id: 'uw-button-viber',
  • id: 'uw-button-vk',
  • id: 'uw-button-skype',
  • id: 'uw-button-whatsapp',
  • id: 'uw-button-instagram',
• Кнопка отправки имэйла при начале диалога в чате - uw-send-email-button
• Нажатие на кнопку "Назад" и на кнопку "Написать нам" при просмотре статьи в базе знаний:
  • uw-button-docs-write
  • uw-button-docs-back