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

概要

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もありません)。ページからの返信は「ページ」名義として記録されます。

よくある状態

補足

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

関連docs