Перейти к основному содержимому

DialogueRead

Диалог — это одна переписка между агентом и контактом в одном канале. В нём отслеживаются стадия переписки, отключён ли бот, состояние отложенного дожима и ссылки на последние сообщения пользователя и бота.

idIdrequired

Уникальный числовой идентификатор записи.

product_idProduct Idrequired

Идентификатор продукта (рабочего пространства), которому принадлежит запись. Большинство эндпоинтов разграничивают доступ по продукту.

customer_id object

Канонический идентификатор клиента на уровне компании для общего контекста общения; null для старых диалогов, которые ещё не были сопоставлены.

anyOf
integer
agent_idAgent Idrequired

Идентификатор агента (настроенного ИИ-ассистента/бота), которому принадлежит запись.

contact_idContact Idrequired

Идентификатор контакта, к которому относится запись.

created_atdate-timerequired

Время создания (UTC, ISO 8601).

channel_idChannel Idrequired

Идентификатор канала, к которому относится запись.

stageStagerequired

Стадия жизненного цикла диалога. Значения, управляемые бэкендом: "initial" (создан), "attempted" (выполнена попытка отправки первого сообщения), "started" (отправка первого сообщения подтверждена), "ongoing" (пользователь ответил хотя бы раз). Прочие значения: "pending" (ожидает запланированного дожима), "failed" (доставка не удалась), "redirected" (переписка переведена на другой контакт), "finished" (достигнут финальный узел дерева состояний). Значения "refused", "success", "disqualified" и "escalated" устарели.

Possible values: [initial, attempted, started, ongoing, pending, failed, redirected, finished, refused, success, disqualified, escalated]

chat_idChat Idrequired

Идентификатор чата на стороне канала, которому соответствует диалог.

last_user_msg_id objectrequired
anyOf
integer
last_user_msg_at objectrequired
anyOf
date-time
last_bot_msg_id objectrequired
anyOf
integer
is_mainIs Mainrequired

Является ли диалог активным (основным) для пары агент/контакт; вытесненные диалоги получают false.

bot_mutedBot Mutedrequired

Если true, бот не отвечает автоматически в этом диалоге (например, после передачи оператору).

pending_until objectrequired

Когда отложенный (pending) диалог должен быть возобновлён (UTC).

anyOf
date-time
pending_type object

Причина отложенного состояния (например, follow_up, human_clarification, n8n_async_tool, custom_follow_up).

anyOf
PendingType

Possible values: [follow_up, human_clarification, n8n_async_tool, custom_follow_up, future_meeting]

pending_ref object

Непрозрачная ссылка, связанная с отложенным состоянием.

anyOf
string
started_at objectrequired

Когда стадия диалога впервые стала "started" (UTC).

anyOf
date-time
ext_id objectrequired

Внешний идентификатор переписки в канале/у провайдера, если есть.

anyOf
string
waba_opener_sent_after_window_num objectrequired
anyOf
integer
is_sub_outreachIs Sub Outreachrequired

Была ли это рассылка в уже существующий чат с контактом, а не «холодная» рассылка. Устанавливается, когда кампания переиспользует канал, в котором с контактом уже общались (опция агента persist_channel_in_outreach): для контакта это та же переписка, но платформа учитывает её в отдельном суточном лимите «sub-outreach», поскольку мессенджеры (WhatsApp, Telegram и т. д.) менее строги внутри существующих диалогов, чем к холодным рассылкам.

warmup_pair_id objectrequired

Для диалогов прогрева номера — пара прогрева, которой принадлежит диалог.

anyOf
integer
is_incomingIs Incomingrequired

Был ли диалог начат входящим сообщением от контакта.

is_group_chatIs Group Chatrequired

Является ли переписка групповым чатом.

skip_response_for_user_msg_id objectrequired
anyOf
integer
skip_response_until objectrequired
anyOf
date-time
last_tree_node_id objectrequired

Идентификатор узла дерева состояний, на котором сейчас находится диалог.

anyOf
integer
subject objectrequired

Тема письма — для канала электронной почты.

anyOf
string
DialogueRead
{
  "id": 0,
  "product_id": 0,
  "customer_id": 0,
  "agent_id": 0,
  "contact_id": 0,
  "created_at": "2024-07-29T15:51:28.071Z",
  "channel_id": 0,
  "stage": "initial",
  "chat_id": "string",
  "last_user_msg_id": 0,
  "last_user_msg_at": "2024-07-29T15:51:28.071Z",
  "last_bot_msg_id": 0,
  "is_main": true,
  "bot_muted": true,
  "pending_until": "2024-07-29T15:51:28.071Z",
  "pending_type": "follow_up",
  "pending_ref": "string",
  "started_at": "2024-07-29T15:51:28.071Z",
  "ext_id": "string",
  "waba_opener_sent_after_window_num": 0,
  "is_sub_outreach": true,
  "warmup_pair_id": 0,
  "is_incoming": true,
  "is_group_chat": true,
  "skip_response_for_user_msg_id": 0,
  "skip_response_until": "2024-07-29T15:51:28.071Z",
  "last_tree_node_id": 0,
  "subject": "string"
}