与客户聊天

Yandex Market API 允许您在聊天室中与客户沟通。

聊天的类型是什么？:

• ORDER — 奉命行事。 关于订单和退款的聊天
• RETURN — 关于退款（FBY, FBS 和 Express). 关于订单和退款的聊天
• DIRECT — 如果客户对产品有疑问，他们就会开始聊天。 卖家无法创建它。 了解有关此类聊天的更多信息

如何检查是否有新的聊天或消息

通过API通知:

燕基科斯.Market会向您发送请求。 POST 通知书 出现新聊天或消息时:

• OnCHAT_CREATED：在系统中创建聊天并保存 chatId. 使用方法获取一次聊天上下文 GET v2/businesses/{businessId}/chat 并保存所述聊天信息。

• OnCHAT_MESSAGE_SENT：仅使用该方法接收消息 GET v2/businesses/{businessId}/chats/message. 如果聊天尚未保存，请使用该方法获取一次 GET v2/businesses/{businessId}/chat 并保存它。

通过主API:

• 检查是否有与买家聊天。 — POST v2/businesses/{businessId}/chats. 在请求中，指定聊天类型以及与其相关的订单或退款的ID。

• 接收一个特定的聊天 — 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，其中传递聊天ID。

3. 使用请求发送消息 POST v2/businesses/{businessId}/chats/message. 如果您需要向买家发送文件 — 例如，附加的产品照片 — 使用请求 POST v2/businesses/{businessId}/chats/file/send.

如何开始聊天

1. 您可以开始新的聊天并使用请求获取其ID。 POST v2/businesses/{businessId}/chats/new. 如果与传输上下文的聊天已经存在，则将返回此聊天的ID。

   如何开始测试聊天

   在调试界面中，创建测试订单，然后单击创建测试聊天或发出请求 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. 使用基于请求中最后一条消息的ID的过滤器，只接收新消息，而不是重新上传您已经拥有的消息。