ログイン無料トライアルを開始
easyCoexistence 公式 API

Facebook ページを API や AI エージェントに接続する方法

Facebook ページは、Facebook Login for Business を通じて API や AI エージェントに接続されます。ページを所有している、またはページ上でタスクを実行できる人が Facebook でサインインし、投稿、コメント、Messenger、インサイトのためのページ権限をアプリに承認します。その後アプリは /me/accounts から各ページのアクセストークンを読み取ります。長期間有効なユーザートークンから発行された場合、そのトークンには有効期限がありません。

easyCoexistence は、Facebook Login for Business で一度サインインするだけで Facebook ページを接続し、各ページのトークンを暗号化して保存し、6時間ごとに確認します。

Owner or task

ある人からページトークンを取得するには、その人がページを所有しているか、ページ上でタスクを実行できる必要があります。

Admin access

Facebook の画面で、ページの管理者アクセス権を与えられた人は、そのページのすべてのタスクを実行できます。

No expiry

長期間有効なユーザートークンから生成された長期間有効なページアクセストークンには、有効期限がありません。

Task access

タスクへのアクセス権を持つ人は、Facebook 上で直接ではなく、Meta Business Suite などのツールでページを管理します。

1 hour

easyCoexistence の接続リンクが有効な期間(セッションが期限切れになるまでの時間)。

ページを接続できるのは誰ですか?

ページを所有している人、またはページ上でタスクを実行できる人です。Meta は、そのような人にのみページアクセストークンを発行するためです。Facebook のページアクセス設定では、完全または一部の管理権限を持つ Facebook アクセス、あるいは Meta Business Suite や Ads Manager で使うタスクアクセスがこれに当たります。Meta の Pages API の概要によると、管理者アクセスはすべてのタスクを対象とします。各呼び出しはその人のタスクに照らして確認されるため、作業を対象とするアクセス権を持つアカウントから接続してください:

  • 投稿の公開:CREATE_CONTENT。
  • コメントへの返信と削除:MODERATE。
  • Messenger の返信とプライベート返信:MESSAGING。
  • インサイト:ANALYZE。

サインイン時に表示されるのは何ですか?

Facebook Login for Business が表示する、Facebook 自身のログインウィンドウです。アプリは、トークンの種類、アセット、必要な権限を指定する設定の config_id を付けて Facebook のログインダイアログを開きます。ユーザーアクセストークンの設定の場合、本人は個人の Facebook アカウントでログインし、自分のページへのアクセスをアプリに許可します。Facebook はコードを返し、アプリのサーバーがそれをユーザートークンに交換し、さらに長期間有効なトークンに交換します。その後、各ページとそのトークンを /me/accounts から読み取ります。

各権限は何のためのものですか?

本人は同じウィンドウ内でまとめて承認し、それぞれが Graph API の一部を利用可能にします。easyCoexistence は以下の9つをリクエストするため、エージェントはページへの投稿、返信、計測ができます。各説明は、Meta の権限リファレンスが、その権限で許可される内容として記載しているものです:

pages_show_listAccess the list of Pages a person manages
pages_read_engagementRead content the Page posted, and metadata and insights about the Page
pages_manage_postsCreate, edit and delete the Page's posts
pages_manage_engagementCreate, edit and delete comments posted on the Page
pages_read_user_contentRead what others post on the Page, such as posts, comments and ratings
pages_manage_metadataSubscribe to webhooks about activity on the Page, and update its settings
pages_messagingManage and access the Page's conversations in Messenger
read_insightsRead Insights data for Pages the person owns
business_managementRead and write with the Business Manager API

どのページが接続として作成されますか?

サインインでトークン付きで返された各ページが、それぞれ独立した接続になり、他の接続と同様に課金されます。すでに別の easyCoexistence アカウントで稼働しているページは、そのまま残り、接続済みと報告されます。そのため、アクセス権を持つ人が有料アカウントからページを奪うことはできません。後でサインインし直すと、その後追加されたページが取り込まれ、すでに接続済みのページのトークンが更新されます。

easyCoexistence にはどのように接続しますか?

ダッシュボードから、一度のサインインで完了します。「新しい接続」を選び、「Facebook」を選択して、ページを運営している Facebook アカウントでサインインし、ページを選択します。各接続は課金対象のため、カードが登録されていないアカウントでは先にカード登録を求められます。Facebook から戻ると、各ページに「接続済み」と表示され、easyCoexistence は feed、messages、mention の Webhook フィールドを購読し、トークンを暗号化して保存し、6時間ごとに確認します。

1New connectionIn the easyCoexistence dashboard
2FacebookFacebook's own login window opens
3ApproveThe Pages and the nine permissions
4ConnectedEach Page ready for Claude, ChatGPT or your code

プラットフォームは顧客のページをどのように接続しますか?

Partner API のホスト型接続リンクを使います。バックエンドから channel を facebook に設定し、redirect_url を付けて /api/v1/connect-sessions に POST し、返された url に顧客を移動させます。顧客は自分の easyCoexistence アカウントを持たずに、Facebook で続行します。ブラウザはセッション、ステータス、channel_id を付けて戻るので、バックエンドから GET /connect-sessions/:id で確認します。サインインで接続された各ページは channel.connected イベントで通知され、すでに別の顧客用にタグ付けされていない限り、external_ref が付与されます。

Create a connect session for a Facebook Page
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "facebook",
    "redirect_url": "https://app.example.com/connect/return",
    "external_ref": "customer_4821"
  }'

接続した後はどうなりますか?

そのページは、そこで動作するものすべてに使える状態になります。list_social_accounts が Claude、ChatGPT、またはご自身のエージェントにそのページを返し、get_social_credentials がそのページ ID と API ベースをお使いのコードに渡します。フィードの変更、Messenger のメッセージ、メンションは、エンドポイントを設定すると、set_social_webhook_destination または PUT /api/v1/channels/:id/webhook. を使ってそのエンドポイントに送られます。

接続が失敗する原因は何ですか?

主に次の4つの理由があり、いずれも直接的な解決策があります:

  • 本人がページを運営していない:Facebook は接続するページを返さないため、そのページにアクセス権を持つ人としてサインインしてください。
  • 本人がサインインをキャンセルした:何も接続されず、もう一度始めると新しいウィンドウが開きます。
  • ページがすでに別の easyCoexistence アカウントに接続されている:先にそちらで削除してください。
  • 接続リンクを開いたのが1時間を過ぎていた:新しいセッションを作成してください。

設定方法

  1. Check your accessMake sure your Facebook account has full control, partial control or task access on the Page.
  2. Start the connectionIn the easyCoexistence dashboard, choose New connection, then Facebook.
  3. Approve the permissionsSign in with Facebook and approve access for the Pages you want to connect.
  4. Point your AI at itAdd https://easycoexistence.com/api/mcp to Claude or ChatGPT, or call the Page from your own code.

よくある間違い

  • 会社を去る予定の人を通じて接続すること。ページトークンはその人のアクセス権に依存しており、権限を失うと動作しなくなります。今後も在籍するアカウントからサインインしてください。
  • リダイレクトのステータスだけを信用すること。誰でも URL に status=connected と入力できるため、バックエンドから GET /connect-sessions/:id でセッションを確認してください。
  • Facebook の接続セッションに webhook_url を送ること。API はそこでそれを拒否します。接続後、PUT /api/v1/channels/:id/webhook で各ページのイベント中継を設定してください。
  • リダイレクトに含まれる channel_id だけを読み取ること。1回の Facebook サインインで複数のページを接続できるため、GET /api/v1/channels を channel と external_ref で絞り込んで一覧を取得してください。
EasyCoexistence で実現する

これにより、Claude、ChatGPT、またはご自身のプラットフォームが、Meta の公式 API を通じて投稿、予約投稿、コメントや DM への返信、インサイトの取得を行えます。料金は接続ごとに月額 US$ 9 から US$ 0.75 までで、接続を増やすほど下がります。最初の 3 日間は無料です。

よくある質問

Facebook ページを接続するために、自分の Meta 開発者アプリが必要ですか?

いいえ。easyCoexistence の Meta アプリがページ権限を要求するため、本人は Facebook でサインインして承認するだけです。自分でアプリ、App Review、Business Verification を用意する必要はありません。

タスクへのアクセス権を持つ人は Facebook ページを接続できますか?

はい。タスクが作業内容を対象とするなら可能です。Meta は、ページ上でタスクを実行できる人にページトークンを与え、その後、各呼び出しをその人のタスクに照らして確認します。

複数の Facebook ページを接続できますか?

はい。サインインで得られた各ページが、それぞれ独立した接続になります。合計数が増えるにつれて、接続ごとに月額 US$ 9 から US$ 0.75 まで課金されます。

ページがすでに別の場所で接続されている場合はどうなりますか?

最初の easyCoexistence アカウントで稼働している間は、2つ目のアカウントに加えることはできません。まず最初のアカウントで削除してから、もう一度接続してください。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日