> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 消息日志

> 检查每条 WhatsApp 入站和出站消息的送达状态。

**消息日志** 页面提供了 YCloud 处理的每条 WhatsApp 消息的记录。成功提交到 YCloud 平台的每条消息都会在此显示。

如果您的企业发送了消息但收件人未收到，请使用消息日志查看消息的当前状态并排查具体的失败原因。

要打开该页面，请前往 **数据分析 > 消息日志**。

<img src="https://mintcdn.com/lchnan/7AejdQWTE_GcFoQy/images/image-20.png?fit=max&auto=format&n=7AejdQWTE_GcFoQy&q=85&s=0833995632ba87f21cd552e90d996a79" alt="Image" width="2914" height="1580" data-path="images/image-20.png" />

## 搜索和筛选消息

默认情况下，消息日志显示 **出站** 消息。要查看从客户收到的消息，请打开 **方向** 筛选器并选择 **入站**。

可用筛选条件包括：

* 联系人信息或模板名称
* 发送时间
* 送达时间
* 国家/地区
* 方向
* WhatsApp 商业号码
* 状态
* 消息类型

组合使用筛选条件以定位特定消息或排查一组相关消息。

<Frame caption="Open Direction and select Inbound to inspect received messages. This view has no matching records.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-2026-09-23/message-direction-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=1c137fa50f7279fb7884941b9b655c9f" alt="显示出站和入站选项的消息日志方向筛选器。" width="3024" height="1656" data-path="product-assets/english-help-2026-09-23/message-direction-annotated.svg" />
</Frame>

此示例显示无匹配消息的搜索结果。

## 了解日志字段

每条记录可包含：

| 字段 | 说明 |
| - | - |
| **发送时间** | 消息由 YCloud 发送或接收的时间。 |
| **送达时间** | WhatsApp 报告消息已送达的时间。 |
| **已读时间** | WhatsApp 报告收件人已读消息的时间。 |
| **国家/地区** | 客户所属的国家或地区。 |
| **方向** | 企业发送的消息为 **出站** ，从客户收到的消息为 **入站** 。 |
| **联系人** | 与该消息关联的客户。 |
| **WhatsApp 商业号码** | 发送或接收消息的企业电话号码。 |
| **消息** | 消息预览或模板名称。 |
| **状态** | 最新的已知消息状态，例如已发送、已送达、已读或失败。 |

对于失败的消息，请在重试前打开该记录或查看其失败详情以查明原因。

<Note>
  如果出站消息未出现在消息日志中，请确认原始请求已成功被 YCloud 接收。
</Note>

## 导出消息日志

点击 **导出** 以下载筛选出的消息记录。导出过程中，您可以选择用于导出时间戳的时区。

导出受权限控制：

* 账户管理员可以导出日志。
* 其他成员必须被授予相应的导出权限。
* 执行导出操作的人员必须完成双重身份验证 (2FA)。

## 常见问题

<AccordionGroup>
  <Accordion title="为什么消息状态为“失败”？">
    消息可能因不同原因而失败。查看该记录的失败详情以了解具体错误，然后在再次发送消息前解决报告的问题。
  </Accordion>

  <Accordion title="为什么已读时间为空？">
    仅在 WhatsApp 报告已读回执后才会显示已读时间。如果收件人禁用了已读回执，YCloud 可能无法收到已读状态。
  </Accordion>

  <Accordion title="为什么“消息”字段显示 [Button] 或 [Unsupported message]，而不是完整内容？">
    WhatsApp 支持多种富媒体和互动消息格式，部分格式无法在日志表格中完整呈现。您可以复制客户的电话号码，并在收件箱中搜索该对话以查看聊天内容。
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.