Messengerプラットフォーム

Messengerプラットフォームの概要

Messengerプラットフォームの概要では、プラットフォームの仕組みとプラットフォームの実装を成功させるために何が必要であるかを詳しく説明しています。

Messenger from Metaは、ビジネスやソーシャルメディアに興味を示した人に対して、ビジネスのFacebookページまたはInstagramプロアカウントで返信できるようにするメッセージサービスです。利用者とビジネスのアカウント間の会話は、利用者側が開始する必要があります。

Messengerプラットフォームは無料でご利用いただけます。

処理の概要

利用者は、FacebookまたはInstagramにログインしている間に、ビジネスページまたはInstagramプロアカウントにメッセージを送信します。またはモバイルアプリやウェブサイトにアクセスしている間に、Metaプラグインで送信します。ビジネスページまたはInstagramプロアカウントは、Messengerプラットフォームを使用し、自動返信、ライブエージェントの返信、または自動化とライブエージェントを組み合わせて、利用者のメッセージを処理できます。

メッセージングフロー

ビジネスページまたはInstagramプロアカウントにメッセージが送信されると、Webhookがトリガーされ、対象のビジネスページまたはInstagramプロアカウントがメッセージを受け取ったという通知を受け取ります。それからアプリはMetaソーシャルグラフを呼び出してこの会話を取得し、適切な返信を判断して、24時間以内に返信を送信することができます。プラットフォームはこの処理を規模に合わせて行うことができ、さまざまな会話エントリポイントとメッセージタイプを提供します。

制限

  • Facebookにログインしている人は、Instagramプロアカウントにメッセージを送信することはできません。また、Instagramにログインしている間は、Messengerプラットフォームを使用してFacebookビジネスページまたはInstagramプロアカウントページにメッセージを送信することもできません。
  • Instagramメッセージは、ビジネス向けのInstagramプロアカウントでも、クリエイター向けのInstagramプロアカウントでも利用可能です。

必要なもの

Messengerプラットフォームを正しく実装するには、以下のコンポーネントについて理解する必要があります。

アクセストークン

Metaアクセストークンはアプリ、Facebookページ、人を識別する不透明文字列であり、アプリはアクセストークンを使うことでMetaソーシャルグラフを安全に呼び出すことができます。アクセストークンは、ビジネスページまたはInstagramプロアカウントが人からのメッセージを送受信できるようにする特定のエンドポイントに対して、一時的かつ安全なアクセスを提供します。詳しくはこちら。

アドバンスアクセスとスタンダードアクセス

ビジネスページまたはInstagramプロアカウントのアプリには、スタンダードアクセスとアドバンスアクセス の2つのアクセスレベルがあります。スタンダードアクセスは、最初にMetaにアプリを登録したときのデフォルトのアクセスレベルです。スタンダードアクセスを利用して、開発者、テスター、管理者などのアプリ上の役割や、アプリを取得したビジネスページ上の役割またはInstagramプロアカウントを持っている人のデータを取得できます。アドバンスアクセスを利用して、アプリを使用しているがアプリ上の役割がない人や、そのアプリを取得したビジネスページ上の役割またはInstagramプロアカウントを持っていない人のデータを取得できます。詳しくは、アプリでの役割、アプリのタイプ、アドバンスアクセスとスタンダードアクセスをご覧ください。

標準アクセスの範囲が制限されているため、一部の機能は、アプリにアドバンスアクセスが付与されるまで正常に機能しないことがあります。そのため、テストアプリの利用が制限される場合があります。

アプリレビュー

アプリ自体に対する役割を持たない、またはアプリを取得したビジネスページ上の役割またはInstagramプロアカウントを持っていないアプリユーザーに関するデータやその人のデータを取得するのにアプリがアドバンスアクセスを必要とする場合、アプリレビューを完了する必要があります。詳しくはこちら。

自社のページのメッセージを送受信するアプリを開発している場合、アプリレビューを受ける必要はありません。ユーザープロフィール情報を取得することを考えている場合は、ユーザープロフィールAPIにアクセスするために必要なアクセス許可を得るため、アプリレビューを通過する必要があります。

ビジネス認証

アプリを使用するのが、そのアプリ自体に対する役割もアプリを取得したビジネスにおける役割も持たないアプリユーザーである場合は、ビジネス認証を完了する必要があります。詳しくはこちら。

コンテンツ配信ネットワークURL

Messengerプラットフォームでは、Instagramユーザーがシェアするリッチメディアコンテンツを取得できるようにするコンテンツ配信ネットワーク(CDN) URLを利用しています。CDN URLはプライバシーに配慮したものであり、コンテンツが削除されるか期限切れになるとメディアを返さなくなります。

Facebookログイン

ページまたはInstagramプロアカウントから特定の人に対してメッセージを送信できるようにするには、許可を求める必要があります。そのためには、Facebookログインを実装する必要があります。詳しくはこちら。

Facebookページ

Messengerプラットフォームを使用してメッセージを送受信するには、Facebookページが必要です。詳しくはこちら。

機能

ヒューマンエージェント機能を使用すると、アプリでヒューマンエージェントが、human_agentタグを使用した利用者からのメッセージに対し、メッセージ受信から7日以内に返信できるようになります。この機能の許可された用途として、標準のメッセージ時間枠内に利用者の問題を解決できない場合に、ヒューマンエージェントによるサポートを提供することができます。例として、ビジネスが週末に休業している場合や、問題の解決に24時間以上必要とする場合などが挙げられます。

ハンドオーバープロトコル

メッセージを処理する複数のアプリがある(例えば、1つのアプリが自動応答を処理し、もう1つのアプリがヒューマンエージェントへのエスカレーションを処理する)場合、1つのアプリから別のアプリにスレッドを渡すハンドオーバープロトコルを実装する必要があります。アプリがメッセージに返信するには会話を管理する必要があります。アプリはハンドオーバープロトコルを使って、メッセージへの返信が必要なときに別のアプリにコントロールをリクエストし、別のアプリからのコントロールを受け入れ、アプリが返信を送信したときに会話のコントロールをリリースできます。

大量メッセージ

ページまたはInstagramプロアカウントが大量のメッセージを送受信した場合、受信箱は、メッセージの量が減るまで新しいメッセージを表示することも新しいメッセージを送信することもできなくなります。

Messengerメッセージの場合

ページが毎秒40件以上のメッセージを送信したり同時に大量の会話の中で常にメッセージを送受信したりしている場合、メッセージの量が減るまでは、ページの受信箱に新しいメッセージが表示されなくなり、ページで新しいメッセージを送信することができなくなります。

ページがメッセージ量の上限に達した場合、すべての会話を受け取るためのAPI呼び出しは失敗しますが、会話の新しいメッセージを受け取るために1つの会話を呼び出すことはできます。

Instagramメッセージの場合

Instagramプロアカウントが72,000件以上のメッセージを送受信した場合、メッセージの量が減るまでは、該当するInstagramの受信箱に新しいメッセージが表示されなくなり、そのInstagramプロアカウントで新しいメッセージを送信することもできなくなります。

会話にバナーが表示され、制限に達したことが示されます。メッセージの量が減ると、これらのバナーは表示されなくなります。

  • メッセージが遅延する可能性があります [your-account-name]が大量のメッセージを受信しているため、メッセージの配信に通常以上の時間がかかる場合があります。

  • メッセージが配信されませんでした [your-account-name]が大量のメッセージを受信しているため、メッセージが配信されませんでした。後でもう一度お試しください。

Instagramプロアカウント

Instagramメッセージを送受信するには、Instagramプロアカウントが必要です。このアカウントがあれば、アカウントにリンクされたFacebookページを使用して、アプリがMetaソーシャルグラフエンドポイントのデータにアクセスできるようになります。詳しくはこちら。

Instagram-Scoped ID

誰かがInstagramプロアカウントにメッセージを送信すると、そのアプリでのその人を表すInstagram-scoped IDが作成されます。このIDは、その人と、その人がやり取りしているInstagramアカウントに固有です。Instagramプロアカウントは、このIDを使うことで、複数のメッセージアプリで同じ人物のやり取りをマッピングできます。

Metaでの登録

Metaソーシャルグラフを呼び出すには、Metaに開発者として登録し、自分のアプリを登録する必要があります。詳しくはこちら。

Page-Scoped ID

誰かがFacebookページにメッセージを送信すると、そのアプリでのその人を表すPage-scoped IDが作成されます。このIDは、その人と、その人がやり取りしているページに固有です。ページは、このIDを使うことで、複数のメッセージアプリで同じ人のやり取りをマッピングできます。

ページタスク

ページアクセストークンをリクエストする人は、メッセージアプリにリンクしたFacebookページで、メッセージを送信するMESSAGINGを実行し、コメントに返信するMODERATEタスクを実行できなければなりません。詳しくはこちら。

パートナーディレクトリ

Messengerプラットフォームに関する専門知識を持ったパートナーをMetaパートナーディレクトリで検索してください。

アクセス許可

アプリは、Messenger会話のために、Facebookログイン経由で次のアクセス許可を求める必要があります。

  • pages_show_list
  • pages_manage_metadata
  • pages_messaging
  • pages_read_engagement
  • business_management

Instagramのメッセージにアクセスするには、次のものを求める必要があります。

  • instagram_basic
  • instagram_manage_messages

business_managementアクセス許可のリクエスト

business_managementアクセス許可をリクエストする際には、アプリレビューの提出情報で以下のようにコールアウトします。

  1. このアクセス許可がpages_messagingとpages_show_listのアクセス許可の依存関係としてリクエストされていること。
  2. Instagramのメッセージでは、このアクセス許可がinstagram_manage_messagesアクセス許可の依存関係としてリクエストされていることをコールアウトします。
  3. アプリレビューのスクリーンキャストでは、ページ管理者がFacebookログインフローをナビゲートし、ページまたはInstagramハンドルを選んで、アプリに必要なアクセス許可を提供していることを明確に示します。

ビジネスアセットを管理するためには、アプリに明示的にアクセス許可を提供する必要があることを、アプリ内でページ管理者に必ず伝えてください。ビジネス向けFacebookログインフローの一部として、business_managementアクセス許可の追加が必要になります。

ポリシー

Metaのソーシャルグラフへのアクセスを取得して保持するには、Messengerプラットフォームポリシー、Metaプラットフォーム利用規約とポリシー、コミュニティ規定を遵守する必要があります。詳しくはこちら。

ボットのポリシー要件

ビジネスページやInstagramプロアカウントから送信されるメッセージの要件は国によって異なる場合があります。これらのポリシー、ならびにMetaが規定しているほかのプラットフォームポリシーに精通してください。

レート制限

Messengerプラットフォームのレート制限は、使用するAPIや、場合によってはメッセージのコンテンツに応じて異なります。

Messenger API

アプリが行うリクエストは、24時間のローリング枠におけるアプリの最大呼び出し可能数に制限され、次のように計算されます。

Calls within 24 hours = 200 * Number of Engaged Users

この「Number of Engaged Users」は、ビジネスがMessengerでメッセージを送信できる人の数を指します。

Instagram用Messenger API

アプリが行うリクエストは、Instagramプロアカウントあたりのアプリの最大呼び出し可能数に制限され、使用するAPIに応じて次のように異なります。

コンバージョンAPI

  • Instagramプロアカウントあたり毎秒2回の呼び出し

送信API

  • テキスト、リンク、リアクション、スタンプが含まれているメッセージの場合、Instagramプロアカウントあたり毎秒100回の呼び出し
  • 音声または動画コンテンツが含まれているメッセージの場合、Instagramプロアカウントあたり毎秒10回の呼び出し

プライベート返信API

  • Instagram Liveコメントに対するプライベート返信の場合、Instagramプロアカウントあたり毎秒100回の呼び出し
  • Instagramの投稿およびリールへのコメントに対するプライベート返信の場合、Instagramプロアカウントあたり毎時750回の呼び出し

Webhooks

Meta Webhooksはリアルタイムの通知であり、ビジネスページやInstagramプロアカウントに送信されたメッセージに関する情報をMetaのソーシャルグラフを呼び出さずに取得できるようにするものですが、レート制限がかかる可能性があります。ビジネスページやInstagramプロアカウントに送信されたメッセージに関する通知を受信するWebhookを、レート制限を回避するように設定する必要があります。

次のステップ

  • Webhooksを設定する – アプリが送受信するメッセージのリアルタイムHTTP通知の受信方法について説明しています。

詳しくはこちら

Messengerプラットフォームについて詳しくは、Metaの開発者動画をご覧ください。これらの動画には、ウォークスルー、ベストプラクティス、録画されたイベントなどが含まれています。