Чаты с покупателями

API Маркета позволяет общаться с вашими покупателями в чатах.

Какие бывают чаты:

• ORDER — по заказам. Чаты о заказах и возвратах
• RETURN — по возвратам (FBY, FBS и Экспресс). Чаты о заказах и возвратах
• DIRECT — чат, который начинает покупатель, если у него есть вопросы по товару. Продавец не может создать его. Подробнее о таких чатах

Как проверить, есть ли новые чаты или сообщения

Через API-уведомления:

Маркет отправит вам запрос POST notification, когда появится новый чат или сообщение:

• На CHAT_CREATED: Создайте чат в своей системе и сохраните chatId. Один раз получите контекст чата методом GET v2/businesses/{businessId}/chat и сохраните информацию о чате.

• На CHAT_MESSAGE_SENT: Получайте только сообщение методом GET v2/businesses/{businessId}/chats/message. Если чат еще не сохранен, получите его один раз методом GET v2/businesses/{businessId}/chat и сохраните.

Через основное API:

• Проверьте, есть ли чат с покупателем — POST v2/businesses/{businessId}/chats. В запросе передайте тип чата и идентификатор заказа или возврата, к которому он относится.

• Для получения одного конкретного чата — GET v2/businesses/{businessId}/chat

Чтобы получить сообщения, используйте методы:

• POST v2/businesses/{businessId}/chats/history — для истории сообщений по чату;
• GET v2/businesses/{businessId}/chats/message — для сообщения.

Как ответить на сообщение

1. Найдите чаты, где нужен ваш ответ. Для этого выполните запрос POST v2/businesses/{businessId}/chats. В запросе передайте статус «Нужен ответ магазина» ("statuses": ["WAITING_FOR_PARTNER"]).

2. Чтобы получить историю сообщений в чате, используйте запрос POST v2/businesses/{businessId}/chats/history, где передайте идентификатор чата.

3. Отправьте сообщение с помощью запроса POST v2/businesses/{businessId}/chats/message. Если вам нужно отправить покупателю файл — например, дополнительную фотографию товара — используйте запрос POST v2/businesses/{businessId}/chats/file/send.

Как начать чат

1. Начать новый чат и получить его идентификатор можно с помощью запроса POST v2/businesses/{businessId}/chats/new. Если чат с переданным контекстом уже существует, то вернется идентификатор этого чата.

   Как начать тестовый чат

   В интерфейсе отладки создайте тестовый заказ, а затем нажмите Создать тестовый чат или выполните запрос POST v2/businesses/{businessId}/chats/new.

   Подробнее о работе с тестовыми заказами

   Обратите внимание:

   • такой чат можно создать только для заказа, не возврата;

   • в тестовых чатах нет ответов покупателей.

2. Отправьте сообщение запросом POST v2/businesses/{businessId}/chats/message. Если вам нужно отправить покупателю файл — например, дополнительную фотографию товара — используйте запрос POST v2/businesses/{businessId}/chats/file/send.

3. Проверяйте новые сообщения от покупателя — POST v2/businesses/{businessId}/chats/history. Используйте в запросе фильтр по идентификатору последнего сообщения, чтобы получать только новые сообщения и не загружать повторно те, что у вас уже есть.