发送 API 参考文档
发送 API 是用于向用户发送消息的主要 API，支持发送文本、附件、模板及发送者操作等。
创建
创建消息并将消息发送给您的客户或对您的 Facebook 公共主页感兴趣的用户。
前期准备
您需要提供：
- 由可以在公共主页上执行
MESSAGE任务的用户请求的公共主页访问口令 pages_messaging权限- 消息接收者必须曾在过去 24 小时内向您的公共主页发送过消息，或者已同意在 24 小时标准消息时间范围过后接收您公共主页发送的消息
限制
- 消息标签无法用于发送推广性内容
请注意，对于使用 recipient.user_ref 或 recipient.phone_number 发送的消息，发送 API 不会在响应中加入 recipient_id 来识别消息收信人。
请求示例
如要向用户发送消息，请向 /PAGE-ID/messsages 端点发送 POST 请求，并在其中设置 messaging_type 和 recipient 参数以及提供消息内容。
以下是针对用户消息的响应示例，其中公共主页发送的消息仅包含文本。
curl -X POST "https://graph.facebook.com/v21.0/{PAGE_ID}/messages" \
-d "recipient={'id':'{PSID}'}" \
-d "messaging_type=RESPONSE" \
-d "message={'text':'hello, world'}" \
-d "access_token={PAGE_ACCESS_TOKEN}"
若请求成功，应用会收到以下 JSON 响应：
{
"recipient_id": "PAGE-SCOPED-ID",
"message_id": "AG5Hz2U..."
}
参数
| 参数 | 描述 |
|---|---|
| 公共主页所发送消息的类型。使用此参数时，必须将其设置为
|
必要 | 所发送消息的类型
|
| 用户将收到的推送通知的类型
|
必要 | 将收到公共主页所发送消息的用户
|
| 消息窗口中显示的操作图标，表示公共主页对收到的用户消息所执行的操作。
仅可以与 |
| 此标签可让您的公共主页在 24 小时标准消息时间范围过后向用户发送消息。
|
消息标签的使用方式
以下表格列出了每个消息标签的消息类型。
| 消息标签 | 用途 |
|---|---|
| 合理用途
禁止用途（非详尽清单）
不适用于 Instagram 消息 API。 |
| 合理用途
禁止用途（非详尽清单）
不适用于 Instagram 消息 API。 |
| 合理用途
禁止用途（非详尽清单）
不适用于 Instagram 消息 API。 |
| 合理用途
禁止用途（非详尽清单）
对于 Instagram 消息 API 为必要项。 |
| 合理用途
禁止用途（非详尽清单）
不适用于 Instagram 消息 API。 |
更新
您无法在此端点上执行此操作。
删除
您无法在此端点上执行此操作。
另请参阅
开发者支持
- 使用 Meta 状态工具
可查看 Meta 商务产品的状态和中断情况。
- 使用 Meta 开发者支持工具 可报告漏洞、查看报告的漏洞、获取有关广告或商务管理平台的帮助等等。
- 访问 Messenger 开放平台支持资源 可查看 Messenger 开放平台的更多支持资源。