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

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

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

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

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

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

   Если чата нет, создайте его с помощью запроса 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. Используйте в запросе фильтр по идентификатору последнего сообщения, чтобы получать только новые сообщения и не загружать повторно те, что у вас уже есть.

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

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.

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

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

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