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 接受的类型如下:
    • 图片: .jpg.jpeg.png
    • 视频: .mp4.3gp
    • 音频: .aac.amr.mp3.m4a.ogg
    • 文档: .txt.pdf.ppt.pptx.doc.docx.xls.xlsx