Messenger Send API:从 Facebook 粉丝专页发送消息
Facebook 粉丝专页通过 POST /{page-id}/messages 发送 Messenger 消息,需要粉丝专页访问令牌。recipient 包含用户的粉丝专页专属 ID(PSID)。在标准消息窗口内,messaging_type 为 RESPONSE 或 UPDATE;窗口之后则使用 MESSAGE_TAG。message 可以是文本,也可以是图片、音频、视频或文件等附件。Meta 会返回 recipient_id 和 message_id。
easyCoexistence 可通过 Claude、ChatGPT 或您自己的代码,在 24 小时窗口内使用 send_social_dm 以文本形式回复 Messenger 私信;媒体、快速回复和模板不在支持范围内。
应用可为每个粉丝专页发起的 Send API 调用次数,适用于含文本、链接、表情回应和贴纸的消息。
应用可为每个粉丝专页发起的 Send API 调用次数,适用于含音频或视频的消息。
Messenger Platform 可保存以供复用的最大资源;通过 URL 上传的图片上限为 8 MB。
一条消息的 attachments 数组中最多可包含的图片数,这也是该数组唯一允许的媒体类型。
已保存的 attachment_id 的有效期,过期后须重新上传媒体。
Send API 请求包含哪些内容?
Meta 列出发送时必须包含的六个组成部分:发送方粉丝专页的 ID、接收方的 ID、该粉丝专页的访问令牌、用户的许可、消息类型和内容。请求是以 JSON 格式向 /{page-id}/messages 发送的 POST。回复刚给粉丝专页发消息的用户时,请求示例如下:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }recipient 应填写哪种 ID?
通常填写 PSID,即 Meta 在某人首次给粉丝专页发消息时为其分配的粉丝专页专属 ID。它会在 messages Webhook 中以 sender.id 的形式送达。recipient 对象还接受其他类型的 ID,适用于特定情形:
- id:PSID,对该用户和该粉丝专页而言是唯一的。
user_ref:用于通过插件或回传按钮(postback)给粉丝专页发消息的用户。comment_id或post_id:用于对评论或访客帖子进行私人回复。- 来自 Facebook Login 的 ID 属于应用范围,无法在 Messenger Platform 上使用。
消息应使用哪种 messaging_type?
该类型说明 Meta 发送此消息的原因,并决定何时允许发送。Meta 粉丝专页消息参考文档列出了四个值:
- RESPONSE:回复粉丝专页收到的消息,无论是否含推广内容,须在标准消息窗口内。
- UPDATE:粉丝专页主动发送的消息,无论是否含推广内容,同样须在窗口内。
MESSAGE_TAG:窗口之后发送的非推广消息,标签须与已获批准的使用场景相符。- UTILITY:基于已获批准模板构建的实用消息,例如订单或预约更新。
一条消息可以包含什么?
文本,或一个包含类型和负载的附件对象。图片、音频、视频和文件附件指向某个 URL 或已保存的 attachment_id;模板附件则携带带按钮的结构化消息。同一端点还接受以下参数:
- attachments:一个数组,最多可将 30 张图片作为一条消息发送。
reply_to与 mid:回复之前的某条特定消息,无论是用户的还是粉丝专页的。quick_replies:输入框上方最多 13 个按钮,每个按钮标题最多 20 个字符。sender_action:输入中提示、已读标记或表情回应,须与消息本身分开,在单独的请求中发送。notification_type:默认为 REGULAR,也可设为SILENT_PUSH或NO_PUSH。
附件可以有多大?
Meta 有关保存资源的指南规定了 Messenger Platform 获取并保存的媒体限制:资源最大 25 MB;通过 URL 上传的图片最大 8 MB;以音频 Content-Type 发送的音频;视频须在 75 秒内完成获取。将 is_reusable 设为 true 会返回一个 attachment_id,只有发送它的粉丝专页可以复用,有效期为 90 天。POST /{page-id}/message_attachments 可提前上传媒体。
Send API 的速率限制是多少?
Meta 按粉丝专页计算调用次数,并区分内容类型。其粉丝专页消息参考文档将 613 列为发送错误之一,即 “Calls to this api have exceeded the rate limit”(此 API 的调用已超出速率限制)。出现该错误时应放慢速度,而不是立即重试:
- 每个粉丝专页每秒 300 次调用,适用于含文本、链接、表情回应和贴纸的消息。
- 每个粉丝专页每秒 10 次调用,适用于含音频或视频的消息。
- 发送给单一会话的消息过多,可能会被单独限速。
- Messenger API 调用总量:滚动 24 小时内,为互动用户数的 200 倍。
- 每秒超过 40 条消息时,粉丝专页收件箱将停止显示新消息,粉丝专页在流量下降前无法发送。
Send API 会返回哪些错误?
Meta 的 Messenger 错误表将每个错误代码与一个说明原因的子代码配对。以下是粉丝专页发送时最常遇到的错误:
- 10,子代码 2018278 或 2534022:此消息在允许的窗口之外发送。
- 10,子代码 2018300:另一个应用控制着该会话。
- 100:参数无效,例如接收方 ID 错误;子代码 2018001 表示未找到匹配用户。
- 551:该用户不可用,可能已屏蔽粉丝专页或停用了账户;200 并带有子代码 1545041 时,表示该用户暂时不可用。
- 200,子代码 2018028:在
pages_messaging通过审核且应用上线之前,应用无法向其角色范围之外的用户发送消息。 - 10904:粉丝专页的设置中已禁用消息功能。
easyCoexistence 如何通过它发送?
send_social_dm 接收 account_id、用户的 recipient_id(即转发的 messages 事件中的 sender.id)以及文本,并以 messaging_type RESPONSE 发送至 /{page-id}/messages。发送成功时返回 Meta 的响应,包含 message_id;发送被拒绝时,则返回 Meta 的错误代码和说明。媒体、快速回复、模板和发送者操作不在这些工具之列:send_social_dm 只发送文本。
常见错误
- 随消息一同发送输入提示。Meta 要求 sender_action 单独与接收方一起发送,文本或模板则需在另一个请求中发送。
- 对同一用户连续突发发送。Meta 可能会对单一会话单独限速,这独立于粉丝专页每秒 300 次调用的限制。
- 以文本速率发送音频或视频。含音频或视频的消息限制为每个粉丝专页每秒 10 次调用。
- 复用超过 90 天的 attachment_id。已保存的附件 ID 会过期,因此请重新上传媒体以获取新的 ID。
自动化功能可使用固定文本或 AI 回复,自动响应新消息。每个连接每月 US$ 9 起,连接越多单价越低,最低降至 US$ 0.75;前 3 天免费。
常见问题
Messenger Send API 免费吗?
是的,针对标准消息。Meta 的概述称 Messenger Platform 可免费使用,因此粉丝专页回复给自己发消息的用户,无需为每条消息付费;营销消息则按条收费。
发送消息需要哪项粉丝专页任务?
Meta 的 Messenger 概述要求提供粉丝专页访问令牌,该令牌须来自能够执行 MESSAGING 和 MODERATE 任务的人员,并已授予 pages_messaging 权限。
easyCoexistence 能否在 Messenger 上回复图片?
目前不能。send_social_dm 仅发送文本,没有任何工具可发送附件。
easyCoexistence 对 Facebook 粉丝专页如何收费?
您连接的每个粉丝专页计为一个连接,每月按连接数计费:每个连接 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75。前 3 天免费。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间