Messages API概要

Messaging APIを使用して、User Profileに連絡してくる相手にダイレクトメッセージ(DM)を管理できます。 相手とは、ユーザー(User Profile)がやり取りしている相手のことです。 会話とは、ユーザー(User Profile)とその相手との間の一連のメッセージです。

• Messaging APIは、すべてのAyrshare Business Planに含まれ、Premiumプランでは有料アドオンとして提供されます。
• BusinessプランとPremiumプランの両方で、Ayrshareダッシュボードのアカウントページでメッセージングを有効にする必要があります。
• メッセージングは、Facebook Messenger、Instagram Direct Messenger、X Direct Messages、およびWhatsApp(Private Beta)で利用可能です。

​

主なメッセージング機能

• ユーザーと相手との会話を管理します。
• ユーザーに代わってテキスト、画像、動画、絵文字メッセージを送信します。
• 完全な会話履歴を取得します。
• 自動メッセージ応答を設定します。
• 受信メッセージ、メッセージへのリアクション、既読レシートに対して、webhook経由でリアルタイムの更新を受け取ります。

​

メッセージングの有効化

​

AyrshareアカウントとUser Profileの有効化

DMを管理するには、まずAyrshareアカウント全体でメッセージングを有効にする必要があります。Ayrshareダッシュボードでアカウントページに移動し、「Learn More」ボタンをクリックしてから「Enable」をクリックします。この時点で、アカウント全体でメッセージングを有効にしましたが、個々のUser Profileに対してはメッセージングを有効にしていません。 個々のUser Profileでメッセージングを有効にするには、User Profilesページで各プロファイルの「Messaging Active」チェックボックスをクリックするか、profilesエンドポイントの作成または更新を使用します。 User Profileでメッセージングを有効にした後、Social Accounts/Social Linkingページでソーシャルアカウント(FacebookとInstagram)を再リンクする必要があります。 有効になると、リンクされたソーシャルアカウントに「Messaging」バッジが表示されます。

​

WhatsApp のメッセージングを有効化

Ayrshare ダッシュボードから直接、Meta の embedded signup フローを通じて WhatsApp Business アカウントをリンクします:

• Meta Business Manager アカウント、WhatsApp Business Account (WABA)、および対象となる電話番号が必要です。Meta は embedded signup 中にアカウントと電話番号を検証します。
• Social Accounts ページで、WhatsApp のタイルの Link をクリックします。Ayrshare が Meta の embedded signup のポップアップを起動し、顧客が Business Manager、WABA、電話番号を選択/作成し、Meta の利用規約に同意する手順を案内します。
• サインアップが完了すると、Ayrshare は選択された WABA と電話番号の所有権を検証し、登録を完了して、アカウントを WhatsApp の webhook にサブスクライブします。Ayrshare ダッシュボードで別途登録 PIN を入力する必要はありません。

​

WhatsApp 固有の重要な動作

• 受信者は ID ではなく電話番号です。 WhatsApp は相手を E.164 の電話番号(数字のみ、+ なし)で識別します。Ayrshare から返される会話 ID も相手の電話番号であり、Facebook や Instagram のような不透明な会話 ID はありません。
• 24 時間カスタマーサービスウィンドウ。 WhatsApp Business では、相手からの直近のメッセージから 24 時間以内でのみ、自由形式のアウトバウンドメッセージが許可されます。そのウィンドウを過ぎると、Meta によって送信が拒否されます。24 時間ウィンドウ外でのテンプレートメッセージは現在 Ayrshare を通じてはサポートされていません。
• API で受信者を直接指定します。 メッセージ送信に受信者の電話番号を渡します。Meta は、その受信者が 24 時間カスタマーサービスウィンドウ内にある場合にのみ、自由形式のメッセージを配信します。コールドアウトリーチには承認済みテンプレートが必要ですが、Ayrshare は現在テンプレート送信を公開していません。
• 配信ステータスは 1 つのフィールドを使用します。 保存されたアウトバウンドメッセージで利用可能な場合、メッセージ取得は status を sent、delivered、read、または failed として返します。配信ステータスの更新と WhatsApp のリアクションは、現在登録された webhook URL にはプッシュされません。
• メディアの種類とサイズ は、Meta が公開している WhatsApp Cloud API の制限に従います — 執筆時点では、画像は最大 5 MB、音声と動画は最大 16 MB、ドキュメントは最大 100 MB です。

​

サポートされる WhatsApp メディア

• Image: .jpg, .jpeg, .png
• Video: .mp4, .3gp
• Audio: .aac, .amr, .mp3, .m4a, .ogg
• Document: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx

​

Instagramアプリでのメッセージングの有効化

Instagramアカウントでメッセージングを有効にする必要がある場合があります:

• Instagramモバイルアプリでプロフィールに移動し、右上のメニューアイコン≡をタップしてSettings and activityページに移動します。
• 下にスクロールしてHow others can interact with youセクションに移動します。
• Messages and story repliesをクリックします。
• Message requestsをタップします。
• Connected toolの下でAllow access to messagesスイッチをオンに切り替えます。

​

メッセージングに関する重要な情報

​

FacebookおよびInstagramのメッセージ履歴取得

FacebookまたはInstagramをリンクしたユーザープロファイルでメッセージングを初めて有効にする場合、会話履歴へのアクセスに関して重要な制限があります:

​

初回接続の制限

• FacebookとInstagramでは、メッセージング用にアカウントを初めてリンクした際、既存の会話から最新20件のメッセージのみ取得できます
• 会話に20件を超えるメッセージがある場合、最初は最新の20件のみアクセス可能です

​

初期設定後

• メッセージングを有効にすると、送受信されたすべての新しいメッセージに完全にアクセスできます
• Ayrshareは今後の完全な会話履歴を維持します
• たとえば: 最初に20件のメッセージを取得し、その後100件の新しいメッセージが交換された場合、合計120件すべてのメッセージにアクセスできます

この制限は、メッセージングを有効にする前に存在した過去のメッセージにのみ適用されます - FacebookとInstagramの今後のすべての会話アクティビティは完全に保持され、アクセス可能です。

​

会話数の上限と料金

• 各Ayrshare User Profileは、請求サイクルごとに最大1,000件のアクティブな会話を持つことができます。アクティブな会話数はすべてのソーシャルネットワークにわたる合計です。
• Premiumプラン: メッセージングはアカウントごとに月額$49の定額アドオンです。
• LaunchプランとBusinessプラン: メッセージングはStripeメーター課金を通じて、アクティブな会話ごとに$0.09で請求されます。ボリュームベースの割引が利用可能です。詳細についてはAyrshareアカウント担当者にお問い合わせください。
• 受信者にメッセージを送信すると、会話は請求サイクルでアクティブとしてカウントされます。受信者からの受信メッセージだけでは、会話をアクティブとしてマークしません。
• 1,000件の会話上限に達した場合、メッセージを受信することはできますが、次の請求サイクルの開始まで応答することはできません。
• アクティブな会話で送受信されるメッセージの数は無制限です。
• 会話上限を増やす必要がある場合は、Ayrshareアカウント担当者にお問い合わせください。

現在の会話数は、userエンドポイントで確認できます。

​

FacebookおよびInstagramでのメッセージング制御の問題

Meta(FacebookとInstagram)は、メッセージング会話に対して「スレッド制御」システムを使用します。これは、一度に1つのアプリだけが会話でメッセージを送信でき、他のアプリはメッセージを受信することしかできないことを意味します。

​

これは何を意味するのか?

**「Message failed to send because another app is controlling this thread now(現在別のアプリがこのスレッドを制御しているため、メッセージの送信に失敗しました)」**というエラーが表示された場合、次のことを意味します:

• 別のサードパーティアプリが現在その会話を制御しています
• Ayrshareはその会話でメッセージを受信することしかできません
• Ayrshareは制御を取り戻すまでメッセージを送信できません

​

この問題を解決する方法

Ayrshareが再びメッセージを送信できるようにするには、会話を制御しているサードパーティアプリを削除する必要があります。 Meta(FacebookおよびInstagram)は、サードパーティアプリを削除するためのプロセスを更新する場合があるため、次の手順を一般的なガイドラインとして使用してください。 Facebookページの場合:

1. Facebook.comに移動し、アカウントにログインします
2. 右上のメニュー(☰)をクリック → Settings & Privacy → Settings
3. 左サイドバーでApps and Websitesをクリックします
4. メッセージングを制御しているサードパーティアプリを見つけます
5. そのアプリの横にあるRemoveをクリックします
6. 削除を確認します

Instagramビジネスアカウントの場合:

1. 電話でInstagramアプリを開きます
2. プロフィールに移動 → メニュー(☰)をタップ → Settings and Privacy
3. Apps and Websitesをタップします
4. サードパーティアプリを見つけて削除します

Instagramの代替方法:

1. business.facebook.comに移動します
2. Business Settingsに移動します
3. Accountsの下でInstagram Accountsをクリックします
4. Instagramアカウントを選択します
5. 接続されたアプリを確認し、問題のあるものを削除します

​

削除後

サードパーティアプリを削除した後:

• スレッド制御は自動的にAyrshareに戻ります
• 再び通常どおりメッセージを送信できるはずです
• ユーザー側でこれ以上のアクションは必要ありません

アプリを削除した後も問題が発生する場合は、サポートチームにお問い合わせください。

​

メッセージwebhook

メッセージ、既読レシート、リアクションを自動的に受信するには、Messages Webhooksをご覧ください。