> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MessengerをCognoに連携する

> FacebookログインでページをOAuth接続し、受信元ページを選び、Messenger送信者をワークスペース memberに対応付けます。受信専用です。

![Messenger](https://mintcdn.com/genaxis/oMT3YnoHFDqPiaPK/images/integrations/messenger.svg?fit=max\&auto=format\&n=oMT3YnoHFDqPiaPK\&q=85\&s=7e8c9eedce0e0d78dbb922d17d09a74e)

> [!NOTE]
>
> **ベータ版。** この連携は利用できますが、メッセージからのタスク・コンテキスト抽出の精度はまだ検証できていません。粗さが残る前提でお使いいただき、気づいた点をお知らせください。

## 概要

| | |
| - | - |
| **方向** | 受信専用 — CognoはFacebookページの会話をまるごと取り込みます。Messengerへ送信はしません。 |
| **接続方法** | Facebookログイン — その後ページを選択します。 |
| **設定できる人** | ワークスペース **owner**。 |
| **必要なもの** | ページを管理するFacebookアカウント（Metaアプリは設定済み）。 |

Messenger連携は**受信専用**です。ここでの「受信専用」とは、**Cognoからページへ送信はしない**という意味で、取り込む会話は片方向ではありません。Facebookページのやり取りを**両方向まるごと**(お客さんからのメッセージも、ページからの返信も)取り込み、ワークスペースのコンテキストやタスクとして扱います。Cognoが自動返信・通知配信を行うことはありません。

連携は2系統で動きます。

* **接続 (OAuth)**: Cognoが対象のFacebookページを扱えるようにする認可です。Facebookログインを通じてページを選びます。
* **受信 (Webhook)**: ページの会話(お客さんのメッセージとページの返信の両方)をCognoへ届ける経路です。Metaアプリ側で設定します。

## 事前確認

* Cogno ワークスペースのownerである。
* 受信元のFacebookページを管理できるFacebookアカウントを使える。
* Metaアプリ側の準備(アプリ作成、Messenger設定、Facebookログイン設定、Webhook設定)が完了している。
  * このMeta側セットアップは管理者向けの作業です。未完了の場合は、先に管理者に依頼してください。
* チーム共通の連携として運用する場合は、個人退職や権限変更で止まらない運用アカウントを使う。

## CognoでMessengerを接続する

1. Cogno appを開きます。
2. 対象ワークスペースの **連携** を開きます。
3. **Messenger** を選択します。
4. **接続** を押します。
5. Facebookの認可画面で、Cognoに許可する内容を確認して承認します。
6. Cognoの画面がページ選択に切り替わります。

接続が完了すると、CognoはOAuth接続を保存し、次のページ選択に進めるようになります。

## Facebookページを選ぶ

1. **Facebook ページ** セクションで、接続したアカウントが管理するページ一覧を確認します。表示されない場合は **再読み込み** を押します。
2. **ページ** の選択メニューから受信元にするページを選びます。
3. 選択すると、Cognoがそのページをwebhookに購読登録し(自動)、接続行にページ名が表示されます。

以後、そのページのやり取り(両方向)がCognoに届くようになります。

## 送信者名について

お客さんの表示名は、Facebookプロフィールから**自動で解決**されます。手動での対応付け作業はありません。Messengerの会話相手はワークスペースの外部の人なので、Cognoのワークスペース memberに紐づける操作は不要です(そのためのUIもありません)。ページからの返信は「ページ」名義として記録されます。

## よくある状態

| State | Meaning | Next action |
| - | - | - |
| Connect画面のまま変わらない | OAuthは完了したが接続レコードがまだ作られていない | 数秒待って画面を更新します。続く場合は管理者にMeta側設定を確認 |
| ページ一覧が空 | 接続アカウントが管理するページが取得できていない | Refreshを押す。対象ページの管理権限があるアカウントか確認します |
| 「アクティブでないアプリです」 | Metaアプリが開発モードで、接続アカウントに役割が無い | 管理者にテスター追加を依頼し、招待を承認します(または管理者で接続) |
| URLを読み込めない / 接続に失敗 | Meta側のOAuthリダイレクト設定が未完了 | 管理者にFacebookログインのリダイレクトURI設定を確認してもらいます |
| メッセージがCognoに入らない | ページのwebhook購読、またはMeta側Webhook設定に不足がある | ページ選択をやり直す。管理者にWebhook購読状態を確認してもらいます |

## 補足

* Messenger連携は受信専用です。Cognoからの自動返信・通知配信はありません。
* Instagramのダイレクトメッセージは別のAPIで、この連携の対象外です。
* 不特定のユーザーにページ接続を提供するには、Metaアプリの公開(App Review + Business Verification)が必要です。開発中はアプリに役割を持つアカウント(管理者/テスター)のみ接続できます。

## 関連docs

* [Troubleshooting](/docs/ja/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.