WhatsApp 日志
WhatsApp 日志部分提供 WhatsApp Cloud API Chat & Marketing 模块处理的所有自动化交互的完整记录。这包括活动送达、机器人触发的响应和基于模板的消息。使用此部分监控活动、排除送达问 题，并维护 WhatsApp 通信的完整审计跟踪。
访问 WhatsApp 日志
从 Perfex CRM 侧边栏导航到 WhatsApp Module > WhatsApp Logs。日志显示在可排序、可搜索的表格中，显示所有自动化消息活动。
日志表列
每个日志条目包含以下信息：
| 列 | 描述 |
|---|---|
| # | 每个日志条目的唯一自增 ID |
| Category | 自动化交互的类型——例如 Marketing Campaign、Template Bot |
| Name | 生成日志条目的活动、机器人或自动化的名称 |
| Template Name | 交互中使用的 WhatsApp 消息模板 |
| Response Code | WhatsApp Cloud API 返回的 HTTP 响应代码（例如 200 表示成功，400 表示错误请求） |
| Type | 收件人类型——例如 Leads、Customers、Contacts |
| Recorded On | 交互记录的日期和时间 |
| Actions | 每个条目的可用操作：查看 详情或 删除 日志记录 |
了解响应代码
响应代码列帮助您快速识别消息是否成功送达或遇到错误。
| 响应代码 | 含义 | 需要的操作 |
|---|---|---|
| 200 | 成功——消息已被 WhatsApp API 接受 | 无需操作 |
| 400 | 错误请求——无效参数或模板问题 | 检查模板和参数 |
| 401 | 未授权——无效或过期的访问令牌 | 在 Meta Business 设置中重新生成访问令牌 |
| 403 | 禁止——权限不足 | 检查您的 System User 权限 |
| 404 | 未找到——无效的电话号码 ID 或端点 | 验证模块设置中的 Phone Number ID |
| 429 | 速率限制——发送请求过多 | 降低发送频率；等待冷却后重试 |
| 500 | 内部服务器错误——WhatsApp API 问题 | 稍后重试；如果持续存在，检查 Meta 状态页面 |
提示
成功的响应代码（200）确认 WhatsApp Cloud API 已接受消息进行送达。它并不保证最终送达到收件人的设备——送达确认通过聊天界面中可见的 webhook 状态更新获得。
筛选日志
使用内置筛选器缩小日志条目范围并快速找到特定记录：
- Category — 按交互类型筛选（Marketing Campaign、Template Bot 等）
- Response Code — 按成功（
200）或特定错误代码筛选 - Type — 按收件人类型筛选（Leads、Customers、Contacts）
- Date Range — 选择开始和结束日期以查看特定时间段内的日志
- Search — 在活动名称、模板名称和其他字段中进行全文搜索
查看日志详情
点击任何日志条目上的 View 操作以查看交互的完整详情，包括：
- 发送到 WhatsApp API 的完整请求负载
- 完整的 API 响应体
- 收件人电话号码和联系人引用
- 使用的模板参数和变量值
- 带时区信息的时间戳
此详细视图对于排除失败的送达或审计特定消息内容非常有价值。
删除日志记录
要删除单个日志条目：
- 点击目标日志行上的 Delete 操作。
- 出现提示时确认删除。
要批量删除日志，使用复选框选择多个条目并点击 Delete Selected。
注意
已删除的日志记录无法恢复。如果您需要出于合规或审计目的保留记录，请在删除前考虑导出数据。
最佳实践
- 定期检查日志 — 检查失败的送达（非 200 响应代码）并及时处理问题以保持活动效果
- 监控速率限制 — 如果您看到频繁的
429响应，请降低活动发送速率或将送达分散到更长的时间窗口 - 保持令牌有效 —
401错误表示您的访问令牌已过期或被撤销；立即更新以恢复功能 - 清理前归档 — 在删除旧日志之前，导出或记录合规、报告或争议解决所需的任何记录
- 使用筛选器进行审计 — 调查特定活动或机器人时，使用 Category 和 Name 筛选器快速隔离相关日志条目
信息
WhatsApp 日志仅捕获 自动化 交互（活动、机器人、模板发送）。员工与客户之间的手动聊天消息存储在聊天历史中，不会在此日志部分中重复。