Skip to main content
POST
向收件人发送一条新的私信。
**定价与限制:**每个 User Profile 每个计费周期最多可有 1,000 个活跃会话(所有社交网络合计)。定价取决于你的计划:Premium 计划为每月 49的统一附加费,LaunchBusiness计划按49** 的统一附加费,而 **Launch** 和 **Business** 计划按 **0.09 每个活跃会话 计费。当你在计费周期内向收件人发送消息时,会话即被计为活跃;仅有入站消息不计入。活跃会话内的消息数量不限。
  • 你可以在 message 文本中包含 emoji。
  • Facebook 和 Instagram 的 mediaUrls 必须以已知扩展名结尾。附加查询参数会导致媒体 URL 失败。
WhatsApp 24 小时客服窗口。 WhatsApp Business 仅允许在通信对象最新一条消息之后 24 小时内发送自由文本的出站消息。超出该窗口后,Meta 将拒绝消息发送,直到通信对象再次发消息为止。目前此端点不支持在 24 小时窗口外发送模板消息。

Header Parameters

Path Parameters

string
必填
用于发送消息的平台:facebookinstagramtwitterwhatsapp

Body Parameters

string
必填
消息收件人的 ID。
  • 对于 FacebookInstagramX/Twitter,此值为对应平台的用户 ID(PSID、IGSID 或 user ID)。
  • 对于 WhatsApp,此值为收件人的电话号码,采用 E.164 仅数字格式(例如 14155551234,而不是 +1 (415) 555-1234)。
string
必填
发送给收件人的消息。
  • 如果提供了 mediaUrls,Facebook、Instagram 和 WhatsApp 的 message 可以为空字符串或不包含。
  • 即使提供了 mediaUrls,X 也要求消息至少包含一个字符。
array
用于附加图片、视频、音频(含语音消息)或文档的媒体 URL 数组。
  • 媒体项目的 URL 应以文件扩展名结尾,且不追加额外参数。
  • Facebook 和 Instagram 支持多个媒体 URL。
  • X 仅接受单个媒体 URL。
  • Facebook 和 Instagram 支持将语音消息以 aacwav 文件的形式发送。
  • WhatsApp 接受多个媒体 URL。Ayrshare 会获取每个 URL,并根据其响应的 Content-Type 选择对应的 WhatsApp 媒体类别。Meta 接受的类型:
    • 图片(Image): .jpg.jpeg.png
    • 视频(Video): .mp4.3gp
    • 音频(Audio): .aac.amr.mp3.m4a.ogg
    • 文档(Document): .txt.pdf.ppt.pptx.doc.docx.xls.xlsx