Передача данных во внешние системы: Webhook

Содержание

• Принцип работы
• Настройка работы
• Webhook отправляемый по закрытию обращения
  • Пример данных
• Webhook отправляемый по назначению обращения
  • Пример данных
• Webhook отправляемый по событию оценки
  • Пример данных

 Принцип работы

Используя webhook LiveTex у вас появляется возможность осуществить интеграцию с внешними системами, в том числе с CRM.

В системе LiveTex такая возможность реализована следующим образом: 

Обратите внимание, что данная функциональность работает только на тарифе "Продвинутый". Подключить его поможет ваш персональный менеджер LiveTex. 

Настройка работы

Для того, чтобы настроить отправку webhook в стороннюю систему, в Личном кабинете LiveTex перейдите в раздел Каналы - Настройки работы - Интеграции.
В разделе Интеграции найдите блок Интеграция посредством Webhook и перейдите по ссылке настроить интеграцию.

В открывшемся окне выполните следующие действия:

1. В поле Адрес для отправки Webhook укажите URL адрес, на который будут отправляться данные,
2. В разделе Настройка событий укажите уведомления о каких событиях вы хотите получать;
3. В разделе Настройка списка точек контакта активируйте те точки контакта, данные о которых требуется получат;
4. Нажмите Сохранить;
5. Если вы готовы начать получать события по настроенным параметрам, нажмите Включить.

Если у вас есть необходимость настроить несколько интеграций с разными внешними системами (например, вам нужно получать другой набор событий на другой URL), нажмите слева Добавить интеграцию и настройте еще одну Интеграцию.

Webhook отправляемый по событию закрытия обращения

Выходные параметры

Conversation

Пример данных

{
  "conversation": {
    "category": "все",
    "creationTime": "2016-07-04T12:06:54",
    "closedTime": "2016-07-04T12:07:04.867050",
    "messages": [{
      "creation_time": "2016-07-04T12:06:54",
      "employee_id": "1",
      "content": "Один заказ отменяем?",
      "sender_type": "discourser"
    }, {
      "creation_time": "2016-07-04T12:06:58",
      "employee_id": "22405",
      "content": "Да",
      "sender_type": "employee"
    }, {
      "creation_time": "2016-07-04T12:07:03",
      "employee_id": "1",
      "content": "Какой оформляем?",
      "sender_type": "discourser"
    }],
    "customInfo": [{
      "name": "VIP клиент",
      "value": "второй"
    }, {
      "name": "Артикул товара:",
      "value": "QW123456"
    }, {
      "name": "client_id",
      "value": "12345"
    }], 
    "tags": [
     "Потенциальный клиент",
     "Вопрос по товару"
     ],
    "communicationType": 1
  },
  "discourser": {
    "name": "Гость",
    "city": "Saint Petersburg",
    "country": " Russian Federation ",
    "contactData": []
  },
  "employee": [{
    "id": "22405",
    "firstName": "Ivan",
    "middleName": "Olegovich",
    "lastName": " Ivanov ",
    "group": [{
      "id": "16535",
      "title": ""
    }, {
      "id": "16758",
      "title": ""
    }]
  }]
}

Webhook отправляемый по событию назначения обращения

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

Выходные параметры

Assignment

{
"assignment":{
        "conversationId":"b9c74128-d1dc-471f-b467-321ec14b895e",
        "subject":"Обращение с сайта livetex.test в отдел Техническая поддержка",
        "conversationCreationTime":"2019-08-08 13:17:46.715 +0300",
        "assignedTime":"2019-08-08 10:17:47.030 +0000",
        "customInfo":[{
            "name":"VIP клиент",
            "value":"Да"
        },{
            "name":"Артикул товара:",
            "value":"QW123456"
        },{
            "name":"client_id",
            "value":"12345"
        }],
    "communicationType":1,
    "touchPoint":{
        "id":"100123",
        "title":"tp.ru"
    },
    "group":{
        "id":"225333",
        "title":"Техническая поддержка"
    }
},
"discourser":{
    "id":"account:35591:site:10032209:visitor:g3r8j37fibtq33di",
    "name":"Ivan",
    "city": "Saint Petersburg",
    "country": " Russian Federation ",
    "contactData": []
  },
"employee":[{
    "id":"36173",
    "firstName":"Aleksandr",
    "middleName":"",
    "lastName":"Zukov",
    "group":[{
        "id":"22577",
        "title":"Техническая поддержка"
    }],
    "email":"test4@yandex.ru"
}]
}

"rating": {
   "rate": {
      "rateType" : 1,
      "rateValue" :"0"
    }
   "conversationId":"bba6d431-99b7-470b-af4f-2a971851362e",
   "ratingEventTime":"2020-02-11 18:54:49.546 +0300"
}