Модель даних повідомлення

Детальна інформація про кожне поле Message Object
Написано Микола
Оновлено 10 місяців тому

API повідомлень дозволяє отримувати та створювати повідомлення від імені контактів або операторів.

Ось приклад відповіді для методів API повідомлень:

{
  "id": 542335,
  "agent": {
    "id": 542335,
    "name": "string",
    "email": "string",
    "role": "string"
  },
  "type": "tech",
  "text": "string",
  "read": true,
  "createdAt": "1603885746",
  "updatedAt": "1603885746",
  "edited": true,
  "broadcastType": "trigger",
  "chat": 542335,
  "from": "agent"
}

Нижче ви можете знайти детальну інформацію про кожне з полів Message Object.

Поле Тип Опис
id Integer Унікальний ID повідомлення, наданий HelpCrunch
agent Object Якщо повідомлення надіслано від оператора, цей об’єкт міститиме id, ім’я, email та роль цього оператора
* Якщо повідомлення було відправлено від Чатбота, воно все одно буде відображатися як відправлене від оператора під назвою "HelpBot".
type String "tech" - системне повідомлення (наприклад, про оновлення статусу)
"email" - повідомлення електронної пошти
"knowledgeBase" - посилання на статтю бази знань
"message" - звичайне повідомлення
"private" - особиста нотатка (тільки для агентів)
text String Текст повідомлення
read Boolean true - повідомлення прочитане. false - повідомлення не прочитане
createdAt Date (UNIX timestamp) Дата та час створення повідомлення
updatedAt Date (UNIX timestamp) Дата та час оновлення повідомлення
edited Boolean true - повідомлення відредаговане. false - повідомлення не було відредаговане
broadcastType String "trigger" - проактивний чат
"auto chat" - цільове чат-автоповідомлення
"auto email" - email-автоповідомлення
"manual chat" - ручне чат-повідомлення
"manual email" - ручне email-повідомлення
chat Integer Унікальний ID чату, наданий HelpCrunch
from String

"оператор" або "контакт" – хто надіслав повідомлення
* зверніть увагу, що у випадку повідомлення від чат-бота, воно все одно буде відображатися як відправлене від оператора.

Приклад відповіді ЧатБота:

{
    "id": 48943,
    "type": "message",
    "text": "Message from bot",
    "read": false,
    "edited": false,
    "createdAt": "1712053945",
    "updatedAt": "1712053945",
    "broadcastType": null,
    "agent": {
        "id": 2,
        "name": "HelpBot",
        "email": "[email protected]",
        "role": "admin"
    },
    "chat": 42068,
    "from": "agent"
}

Чи була наша стаття корисною?