Интеграции с внешними системами

Принцип работы
JSON 
Пример данных

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

На стороне LiveTex реализован webhook, предоставляющий внешним клиентским сервисам данные о завершённом обращении. В личном кабинете LiveTex (https://my.livetex.ru/products/integrations) можно указать URL адрес, на который будут отправляться данные в формате JSON каждый раз, когда сотрудник будет закрывать обращение в приложении оператора. 

Webhook — механизм получения уведомлений об определённых событиях LiveTex в свою собственную систему. Webhook на стороне LiveTex позволяет получать уведомления о каждом событии закрытия диалога оператором. Таким образом, используя webhook, LiveTex предоставляет возможность осуществить интеграцию с внешними системами, в том числе с CRM.

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


JSON


Выходные параметры
НазваниеТипОбязательностьОписание
ConversationConversation+Обращение
discourserDiscourser+Собеседник
employeeArray+Список сотрудников, участвовавших в обращении
Conversation
НазваниеТипОбязательностьОписание
categorystring+Тип обращения (тех. поддержка, консультация по продаже и т.д.)
creationTimedatetime+ Время создания обращения
closedTimedatetime+Время закрытия обращения
messagesArray<Message>+Сообщения в обращении
discourserRatestring-Оценка собеседником
customInfoArray<CustomInfo>-Пречат поля
communicationTypeEnum+Канал
communicationType
КлючЗначение
1Чат на сайте
2Офлайн-заявка
3Заказ звонка
4Мобильное приложение
5Email
6Facebook
7Telegram
8ВКонтакте
9Viber
10WhatsApp
11Одноклассники
12Messaging API
13Яндекс.Диалоги
Message
НазваниеТипОбязательностьОписание
creation_TimedateTime+Время создания сообщения
employee_idstring + Идентификатор сотрудника, отправившего сообщение, если «NULL», то отправитель - собеседник
Contentstring +Текст сообщения
sender_typeSenderType+Тип отправителя
SenderType
КлючЗначениеОписание
EMPLOYEE“employee”Сотрудник
DISCOURSER”discourser”Собеседник
CustomInfo
НазваниеТипОбязательностьОписание
Namestring+Наименование поля
Valuestring+ Значение поля
Discuorser
НазваниеТипОбязательностьОписание
Name string -Имя собеседника.
City string - Город, из которого написал собеседник. Определяется по GeoIP.
Country string -Страна, из которой написал собеседник. Определяется по GeoIP.
contactData Array<ContactData> -Контактная информация
ContactData
НазваниеТипОбязательностьОписание
Valuestring+Значение контакта
Contact_date_type ContactDataType + Тип контакта (email или телефон)
ContactDataType
КлючЗначениеОписание
EMAIL“email”email
PHONE”phone”Телефон
Employee
НазваниеТипОбязательностьОписание
IdString+Уникальный (в рамках LiveTex) идентификатор сотрудника
firstNameString+Имя сотрудника
middleNameString+Отчество сотрудника
lastNameString+Фамилия сотрудника
GroupArray<Group>+Группа сотрудника, в рамках которой велось Обращение
Group
НазваниеТипОбязательностьОписание
IdString+Уникальный (в рамках LiveTex) идентификатор группы
TitleString+Название группы

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

{
  "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"
    }],
    "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": ""
    }]
  }]
}

Feedback and Knowledge Base