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

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

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

  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.

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

Подключите API-уведомления

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

Как работать с уведомлениями

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

Предыдущая
Следующая