この文書は元の英語版を機械翻訳したものです。翻訳版と英語版の間に相違がある場合は、英語版が優先されるものとします。 英語版の原文を読む

メッセージングゲートウェイ：連絡先が既に使用しているアプリで Caiioo に回答させる

メッセージングゲートウェイは、顧客や連絡先が既に使用しているプラットフォームで Caiioo がメッセージを送受信するための、サービスに依存しない方法です。ユーザーが WhatsApp や Telegram など、普段使っている場所からメッセージを送ると、エージェントがそのチャンネル内でリアルタイムに自律的に回答します。同じゲートウェイは逆方向でも機能します。任意のスレッドから、エージェントはツールとしてメッセージを送信できます（「Telegram のチームグループに会議についてメッセージを送って」）。

1つのゲートウェイで、多くのサービスに対応。各サービスを一度接続すれば、Caiioo はすべてを単一のインターフェースに統合します。

サポートされているサービス

**「設定」>「接続」>「メッセージングゲートウェイ」**で以下のいずれかを接続します：

WhatsApp Business — 安定版
Telegram — 安定版
Messenger（ベータ）
iMessage（ベータ）
Signal（ベータ）
Viber（ベータ）
Beeper（ベータ）

WhatsApp BusinessとTelegramは安定版です。残りはベータ版であり、完全に利用可能ですが引き続き安定性強化を行っています。

セットアップ

設定 > 接続 > デバイスとリレー > プライベートリレーで、このデバイスのリモートアクセスをオンにします。これにより、受信メッセージを受け取るリレーにデバイスが実際に接続されます。これがオフの場合、以下のサービスをどのように設定してもメッセージは届きません。デフォルトではオフになっており、デバイスごとに設定されます（下記のプラットフォームサポートを参照）。
設定 > 接続 > メッセージングゲートウェイに移動します。
サービスを選択します。
そのプロバイダーの標準的なボットまたはビジネス認証情報を入力します。そのプラットフォームの他の連携で使用するのと同じトークンやビジネスアカウントです。
Caiiooが受信ルートを登録します。まだどこでもリモートアクセスがオンになっていない場合、「設定 > 接続 > メッセージングゲートウェイ」にその旨が表示され、その場でオンにできます。

各サービスの設定は一度だけ行います。その後は、接続されているサービスの数に関係なく、エージェントは単一のメッセージング機能として認識します。

会話ごとのインタラクションモード

すべての会話には独自のモードがあり、スレッド上部の3つのボタンから選択できます。連絡先ごとにエージェントの対応方法を正確に決定できます：

自動 (緑)

エージェントがすべての人に自動的に回答します。そのスレッドであなたが入力した内容はすべてコーチングとして扱われます。それはエージェントの次の返答に反映されますが、連絡先には送信されません。エージェントに会話を任せつつ、時々指示を出したい場合（「もっと丁寧に」「割引を提示して」など）に使用します。

割り込み (青)

エージェントは引き続き受信メッセージに自動回答しますが、あなたが入力した内容はすべてあなたとして連絡先に直接送信されます。エージェントに会話を継続させつつ、自分でも会話に加わりたい場合に使用します。

チャット (黄)

エージェントは一時停止して身を引きます。自動応答を停止し、あなたが自分で会話を処理します。あなたのメッセージはあなたとして連絡先に送信されます。スレッドに人間が必要で、エージェントを介在させたくない場合に使用します。

双方向のメディア対応

画像、音声、動画は双方向に流れます。連絡先が写真を送信すると、それはモデルに届きます。そのため、「顧客が今送ってきたこの写真には何が写っていますか？」と尋ね、同じチャンネルですぐに回答できます。エージェントが生成または添付したメディアも、同様に連絡先に送信されます。

プライバシーとアーキテクチャ

すべてのメッセージ処理は、リモートアクセスがオンになっているデバイス（デスクトップアプリ、ブラウザ拡張機能、またはその両方）上でローカルに行われます。エージェントはご自身のマシン上で実行され、会話、認証情報、メディアはその場で処理され、クラウド上では処理されません。

Cloudflareは、ユーザーごとの単純なWebhookリレーとしてのみ機能します。各ユーザーはシングルテナントのDurable Objectを取得し、プライベート接続を介して生のエンドポイントWebhookをデバイスに転送するだけで、それ以上のことは行いません。クラウドでのメッセージ保存やクラウド側での処理は一切ありません。アウトバウンドメッセージはCloudflareを完全にバイパスし、お使いのデバイスからサービスのAPIを直接呼び出します。外部サービスがインバウンドWebhookを配信するための安定したパブリックURLを必要とするためだけに、Cloudflareが介在しています。

プラットフォームサポート

メッセージを受信できるかどうかを実際に決定するのはリモートアクセス（設定 > 接続 > デバイスとリレー > プライベートリレー）です。これはデバイスごとのスイッチで、デフォルトでオフになっており、意図的にデバイス間で同期されません（ポート開放のようなネットワーク公開設定であるためです）。メッセージに応答させたいすべてのデバイスでオンにし、応答させたくないデバイスではオフのままにしてください。

macOS、Windows、Linux — サポートされています。デスクトップアプリでリモートアクセスをオンにすると、メッセージに応答します。
ブラウザ拡張機能（Chrome、Safari） — サポートされており、デスクトップアプリ不要で単独で完全に動作します。拡張機能自体の設定でリモートアクセスをオンにすると、直接接続して単独でメッセージに応答します。
デスクトップアプリと拡張機能の両方でリモートアクセスが同時にオンになっている場合、デスクトップアプリが優先されます。拡張機能は、デスクトップアプリがオフラインになったときのバックアップとして待機状態になります。
iOSまたはAndroid — 利用不可。モバイルアプリではゲートウェイが依存するプライベートリレーのクライアントが動作しないため、リモートアクセスの設定に関係なく、受信メッセージの受け取りや応答はできません。

Slack に関する注意

Slack はメッセージングゲートウェイの一部ではありません。Slack は Community Hub に独自の OAuth パッケージとして存在しています。そこからインストールしてください。Community Hub を参照してください。

ティア

メッセージングゲートウェイは Pro 機能です。