Skip to main content
POST
受信者に新しいダイレクトメッセージを送信します。
料金と制限: 各 User Profile は、すべてのソーシャルネットワークをまたいで 請求サイクルごとに最大 1,000 件のアクティブな会話 を持てます。料金はプランに依存します: Premium プランは月額 49の定額アドオンを支払い、LaunchおよびBusinessプランはアクティブな会話1件あたり49** の定額アドオンを支払い、 **Launch** および **Business** プランは **アクティブな会話 1 件あたり 0.09 で請求されます。会話は、請求サイクル中に受信者へメッセージを送信した時点で アクティブとしてカウントされます。受信メッセージのみではカウントされません。アクティブな会話内のメッセージ数は無制限です。
  • message テキストの一部として絵文字を送信できます。
  • Facebook と Instagram の mediaUrls は既知の拡張子で終わる必要があります。クエリパラメーターを含めるとメディア URL が失敗します。
WhatsApp の 24 時間カスタマーサービスウィンドウ。 WhatsApp Business では、相手からの直近のメッセージから 24 時間 以内でのみ、自由形式のアウトバウンドメッセージを許可しています。このウィンドウを過ぎると、相手が再度メッセージを送るまで Meta によって送信が拒否されます。24 時間ウィンドウ外でのテンプレートメッセージは、このエンドポイントを通じて現在サポートされていません。

Header Parameters

Path Parameters

string
必須
メッセージを送信するプラットフォーム: facebook, instagram, twitter, whatsapp

Body Parameters

string
必須
メッセージ受信者の ID。
  • FacebookInstagramX/Twitter の場合、これはプラットフォーム固有のユーザー ID(PSID、IGSID、または user ID)です。
  • WhatsApp の場合、これは受信者の電話番号で、E.164 の数字のみの形式です(例: 14155551234 であって +1 (415) 555-1234 ではありません)。
string
必須
受信者に送信するメッセージ。
  • Facebook、Instagram、および WhatsApp では、mediaUrls を指定する場合、message は空文字列にするか、完全に省略することができます。
  • X では、mediaUrls を指定する場合でも、少なくとも 1 文字以上のメッセージが必要です。
array
画像、動画、音声(音声メッセージを含む)、またはドキュメントを添付するためのメディア URL の配列。
  • メディア項目の URL はファイル拡張子で終わる必要があり、追加のパラメーターが付加されていてはいけません。
  • Facebook と Instagram は複数のメディア URL をサポートします。
  • X は単一のメディア URL のみ受け付けます。
  • 音声メッセージは Facebook と Instagram で aac または wav ファイルとしてサポートされます。
  • 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