Чаты с покупателями
API Маркета позволяет общаться с вашими покупателями в чатах.
Как начать чат
-
Проверьте, есть ли чат с покупателем — POST v2/businesses/{businessId}/chats. В запросе передайте тип чата и идентификатор заказа или возврата, к которому он относится.
Если чата нет, создайте его с помощью запроса POST v2/businesses/{businessId}/chats/new.
Как начать тестовый чат
В интерфейсе отладки создайте тестовый заказ, а затем нажмите Создать тестовый чат или выполните запрос POST v2/businesses/{businessId}/chats/new.
Подробнее о работе с тестовыми заказами
Обратите внимание:
-
такой чат можно создать только для заказа, не возврата;
-
в тестовых чатах нет ответов покупателей.
-
-
Отправьте сообщение запросом POST v2/businesses/{businessId}/chats/message. Если вам нужно отправить покупателю файл — например, дополнительную фотографию товара — используйте запрос POST v2/businesses/{businessId}/chats/file/send.
-
Проверяйте новые сообщения от покупателя — POST v2/businesses/{businessId}/chats/history. Используйте в запросе фильтр по идентификатору последнего сообщения, чтобы получать только новые сообщения и не загружать повторно те, что у вас уже есть.
Как ответить на сообщение
-
Найдите чаты, где нужен ваш ответ. Для этого выполните запрос POST v2/businesses/{businessId}/chats. В запросе передайте статус «Нужен ответ магазина» ("statuses": ["WAITING_FOR_PARTNER"]).
-
Чтобы получить историю сообщений в чате, используйте запрос POST v2/businesses/{businessId}/chats/history, где передайте идентификатор чата.
-
Отправьте сообщение с помощью запроса POST v2/businesses/{businessId}/chats/message. Если вам нужно отправить покупателю файл — например, дополнительную фотографию товара — используйте запрос POST v2/businesses/{businessId}/chats/file/send.
Как проверить, есть ли новые чаты или сообщения
Подключите API-уведомления
Маркет отправит вам запрос POST notification, когда появится новый чат или сообщение.
Чтобы получить чаты или сообщения, используйте методы:
- GET v2/businesses/{businessId}/chat — для одного чата;
- POST v2/businesses/{businessId}/chats — для списка чатов;
- GET v2/businesses/{businessId}/chats/message — для сообщения;
- POST v2/businesses/{businessId}/chats/history — для истории сообщений.