文档已更新。
中文(简体) 译文尚未完成。
英语更新时间:2023年12月15日

将消息标记为已读

从 Webhooks 收到传入消息后,您可以使用 /messages 端点将该消息的状态更改为 read,从而将消息标记为已读。如果消息被标记为已读,其时间戳旁会显示两个蓝色勾号:


我们建议将 30 天内收到的传入消息标记为已读。您无法将您发出的传出消息标记为已读。如果将一条消息标记为已读,同一对话中比该消息早的消息也都会被标记为已读。

准备工作

您将需要:

更新状态

如要将消息标记为已读,请向 messaging_product 设置为 whatsappmessage_id 设置为消息编号且 status 设置为 read/PHONE_NUMBER_ID/messages 端点发送 POST 请求。

请求示例

为方便阅读,示例格式已经过调整
curl -X POST \
'https://graph.facebook.com/v19.0/PHONE_NUMBER_ID/messages'
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
  "messaging_product": "whatsapp",
  "status": "read",
  "message_id": "MESSAGE_ID"
  }'

若请求成功,系统将返回 JSON 数组:

{
  "success": true
}