Получение истории сообщений в чате
Метод доступен для всех моделей.
Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке
- communication — Общение с покупателями
- all-methods — Полное управление кабинетом
- all-methods:read-only — Просмотр всех данных
Возвращает историю сообщений в чате с покупателем.
⚙️ Лимит: 10 000 запросов в час |
---|
Request
POST
https://api.partner.market.yandex.ru/v2/businesses/{businessId}/chats/history
Path parameters
Name |
Description |
businessId* |
Type: integer<int64> Идентификатор кабинета. Чтобы его узнать, воспользуйтесь запросом GET v2/campaigns. ℹ️ Что такое кабинет и магазин на Маркете
Min value: |
Query parameters
Name |
Description |
chatId* |
Type: integer<int64> Идентификатор чата. Min value: |
limit |
Type: integer<int32> Количество значений на одной странице.
Min value: |
page_token |
Type: string Идентификатор страницы c результатами. Если параметр не указан, возвращается первая страница. Рекомендуем передавать значение выходного параметра Если задан |
Body
application/json
{
"messageIdFrom": 0
}
Name |
Description |
messageIdFrom |
Type: integer<int64> Идентификатор сообщения, начиная с которого нужно получить все последующие сообщения. Min value: |
Responses
200 OK
История сообщений.
Body
application/json
{
"status": "OK",
"result": {
"orderId": 0,
"context": {
"type": "ORDER",
"customer": {
"name": "string",
"publicId": "string"
},
"campaignId": 0,
"orderId": 0,
"returnId": 0
},
"messages": [
{
"messageId": 0,
"createdAt": "2017-11-21T00:00:00+03:00",
"sender": "PARTNER",
"message": "string",
"payload": [
{
"name": "string",
"url": "string",
"size": 0
}
]
}
],
"paging": {
"nextPageToken": "string"
}
}
}
Name |
Description |
result |
Type: ChatMessagesResultDTO Информация о сообщениях. |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
ChatMessagesResultDTO
Информация о сообщениях.
Name |
Description |
context* |
Type: ChatFullContextDTO Информация о заказе или возврате, по которому начат чат. |
messages* |
Type: ChatMessageDTO[] Информация о сообщениях. |
orderId ⦸
|
Type: integer<int64> Идентификатор заказа. |
paging |
Type: ForwardScrollingPagerDTO Идентификатор следующей страницы. |
ApiResponseStatusType
Тип ответа. Возможные значения:
OK
— ошибок нет.ERROR
— при обработке запроса произошла ошибка.
Type |
Description |
Enum: |
ChatFullContextDTO
Информация о заказе или возврате, по которому начат чат.
Name |
Description |
type* |
Type: ChatContextType Тип контекста:
Enum: |
campaignId |
Type: integer<int64> Идентификатор кампании. Возвращается для заказов и возвратов. |
customer |
Type: ChatCustomerDTO Информация о покупателе. |
orderId |
Type: integer<int64> Идентификатор заказа. Возвращается для заказов и возвратов. Min value: |
returnId |
Type: integer<int64> Идентификатор возврата. Возвращается только для возвратов. Min value: |
ChatMessageDTO
Информация о сообщении.
Name |
Description |
createdAt* |
Type: string<date-time> Дата и время создания сообщения. Формат даты: ISO 8601 со смещением относительно UTC. Example: |
messageId* |
Type: integer<int64> Идентификатор сообщения. Min value: |
sender* |
Type: ChatMessageSenderType Отправитель. Enum: |
message |
Type: string Текст сообщения. Необязательный параметр, если возвращается параметр |
payload |
Type: ChatMessagePayloadDTO[] Информация о приложенных к сообщению файлах. Необязательный параметр, если возвращается параметр Min items: |
ForwardScrollingPagerDTO
Идентификатор следующей страницы.
Name |
Description |
nextPageToken |
Type: string Идентификатор следующей страницы результатов. |
ChatContextType
Тип контекста:
ORDER
— чат по заказу. Чаты о заказах и возвратахRETURN
— чат по возврату (FBY, FBS и Экспресс). Чаты о заказах и возвратахDIRECT
— чат, который начал покупатель. Сообщения от покупателей
Type |
Description |
Enum: |
ChatCustomerDTO
Информация о покупателе в чате.
Name |
Description |
name |
Type: string Публичное имя покупателя в Яндекс Паспорте, которое отображается в сервисах Яндекса. Min length: |
publicId |
Type: string Публичный идентификатор пользователя в Яндекс Паспорте. Примеры, где используется
Подробнее о публичных данных читайте в документации Яндекс ID. Min length: |
ChatMessageSenderType
Кто отправил сообщение:
PARTNER
— магазин.CUSTOMER
— покупатель.MARKET
— Маркет (автоматическое сообщение).SUPPORT
— сотрудник службы поддержки Маркета.
Type |
Description |
Enum: |
ChatMessagePayloadDTO
Информация о приложенных к сообщению файлах.
Name |
Description |
name* |
Type: string Название файла. |
size* |
Type: integer<int32> Размер файла в байтах. |
url* |
Type: string Ссылка для скачивания файла. Min length: Max length: |
400 Bad Request
Запрос содержит неправильные данные. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
ApiErrorDTO
Общий формат ошибки.
Name |
Description |
code* |
Type: string Код ошибки. |
message |
Type: string Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
404 Not Found
Запрашиваемый ресурс не найден. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
420 Method Failure
Превышено ограничение на доступ к ресурсу. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
500 Internal Server Error
Внутренняя ошибка Маркета. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
No longer supported, please use an alternative and newer version.
Например, Пожалуйста, не запрашивайте у покупателей контакты, не присылайте ссылки на другие сайты. Мы видим переписку и скрываем товары с витрины, когда правила общения в чатах нарушаются.