AI エージェント SaaS のアーキテクチャ:WhatsApp、Instagram、TikTok で顧客のお客様に返信する
顧客のお客様に届く AI エージェント SaaS は、五つの層で動作します。第一は接続です。各顧客は easyCoexistence の Partner API を通じて、WhatsApp、Instagram、TikTok などのチャネルを連携します。第二は受信で、Webhook を検証してキューに入れます。第三は会話ストアで、こちらは御社が管理します。第四はエージェントワーカーで、御社のモデルを実行します。第五は送信で、各ネットワークの公式 API を通じて返信と投稿を行い、ステータスイベントを追跡します。
WhatsApp Business アプリから Coexistence 番号で送信されたメッセージを表す Webhook。
エンドポイントが受け付けなかった WhatsApp の Webhook を Meta が再送する期間。同じメッセージが二度届くことがあります。
転送された Instagram、Facebook、TikTok の各イベントの配信。再送はなく、コピーも保持されません。
人からのメッセージの後に開く WhatsApp のカスタマーサービスウィンドウ。その外では、承認済みのメッセージテンプレートだけを送れます。
WhatsApp Business アプリと Cloud API の両方で使用する番号の、固定のスループット。
AI エージェント SaaS の層は何ですか?
五つあり、それぞれに一つの役割があります。そのため、遅いモデルがメッセージを失うことはなく、アカウントが切断されても製品全体は止まりません。easyCoexistence は最初と最後の層を担当します。アカウントを接続して稼働を維持し、会話のロジックとモデルはバックエンドに残します。
テナント、チャネル、会話はどのようにモデル化しますか?
テーブル三つで表します。テナントは顧客で、その id はすべての接続セッションに external_ref として渡されます。そのため、各接続とステータスイベントには必ずテナントのタグが付いて戻ってきます。チャネルの行には、WhatsApp 番号の connection_id、またはソーシャルアカウントの channel_id、そしてネットワークとそのステータスを保持します。会話は、チャネルと、そのネットワーク上での相手の ID で識別します。WhatsApp では from の電話番号、Instagram の DM ではスコープ付きの ID、TikTok ではコメントのスレッドです。
受信したイベントは最初にどこへ入れますか?
モデルが動く前に、永続キューに入れます。受信エンドポイントは、WhatsApp の配信では URL パスのシークレットを、転送されたソーシャルイベントでは X-EC-Signature を確認し、イベントをキューに書き込んで 2xx で応答します。二つの送信元は動作が異なります。Meta は WhatsApp の Webhook を最大 7 日間再送するため、同じメッセージが二度届くことがあります。一方、転送された Instagram、Facebook、TikTok のイベントは一度だけ送られ、保持もされないため、エンドポイントで取りこぼしたイベントは失われます。重複は、ネットワーク側のメッセージ ID またはコメント ID で排除してください。
返信の順序と期限をどう守りますか?
会話ごとにワーカーを一つ置き、送信の前に確認を行います。エージェントの処理中は会話をロックし、同じ相手からの二つのメッセージが順番どおりに一度だけ返信されるようにします。WhatsApp の返信を送る前に、相手の最後のメッセージから 24 時間のウィンドウを確認し、閉じていれば承認済みテンプレートに切り替えます。番号ごとの送信は、Coexistence 番号の固定レートである毎秒 20 件を上限としてキューに入れてください。また、TikTok の返信は公開コメントであることを忘れないでください。
人がエージェントから担当を引き継ぐには?
チャネルそのものを通じて行われます。Coexistence では、顧客の担当者は同じ番号で WhatsApp Business アプリを使い続け、送信した各メッセージは smb_message_echoes として御社の Webhook に届きます。このエコーを引き継ぎとして扱い、その会話のエージェントを一時停止します。担当者の返信は文脈としてモデルに渡し、一定時間やり取りがない期間の後、または担当者が御社の製品で担当を戻したときに再開します。Instagram も、アカウント自身の DM をエコーとして返すため、同じルールでエージェントが自分自身に返信してしまうのを防げます。
エージェントは返信に加えて投稿もすべきですか?
同じキーで投稿もできます。エージェントが投稿を下書きし、御社のバックエンドが POST /channels/:id/posts で Instagram、Facebook、TikTok、LinkedIn への投稿をキューに入れます。投稿は 1 分先から 90 日先まで予約でき、post.published と post.failed の結果は会話ストアに報告されます。LinkedIn の投稿は、製品上で人が一件ずつ承認してからのみ送られます。LinkedIn の API 利用規約が自動投稿を制限しているためです。
接続が切れたとき、製品はどう反応しますか?
チャネルの行の状態を通じてです。ステータスイベントで disconnected、removed、suspended のいずれかになると、エージェントはそのチャネルでの送信を止め、御社の画面は新しい接続セッションで再接続するようテナントに求めます。connection.token_missing イベントの場合は、番号は受信できても送信できない状態のため、エージェントは返信を下書きして担当者に渡します。connection.connected または channel.connected を受け取ると行は active に戻り、ワーカーは次の返信の前に新しい認証情報を取得します。
御社はどのデータを保存し、easyCoexistence は何を保持しますか?
会話は御社の製品に保存されます。WhatsApp 番号のメッセージは Meta から御社の Webhook に直接届き、転送されたソーシャルイベントは、コピーを残さず easyCoexistence を通過します。easyCoexistence が保持するのは、接続を提供するために必要なものです。アカウントのレコード、そのトークン、接続状態の履歴、そして公開した投稿です。御社のアカウントで easyCoexistence 独自の自動化も有効にしている場合、そのメッセージ本文は 7 日間、実行ログは 30 日間保持されます。
よくある間違い
- 相手の電話番号だけで会話を識別すること。同じ相手が御社の二つのテナントに連絡することがあるため、各スレッドはチャネルと相手の ID を組み合わせて識別してください。
- 一つの会話に二つのワーカーが返信すること。並列のワーカーは返信の順序を乱したり二重に送ったりするため、エージェントの処理中はスレッドをロックしてください。
- 担当者が WhatsApp Business アプリから返信した後も、エージェントを動かし続けること。エコーは、人がスレッドを引き継いだことを示します。そのため、御社の引き継ぎルールがエージェントを戻すまで、そこで停止してください。
- エージェントの LinkedIn の下書きをタイマーで公開すること。LinkedIn の投稿は一件ずつ人が承認するため、キューに届く前に下書きをレビュー工程へ回してください。
easyCoexistence はエージェント製品の接続レイヤーです。顧客の WhatsApp 番号、そして Instagram、Facebook、TikTok、YouTube、LinkedIn のアカウント、さらに他のチャネルも、ホスト型のリンクで接続します。最新の認証情報、Webhook、投稿キュー、署名付きのステータスイベントを提供し、すべての接続を 24/7 で監視します。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
顧客のお客様は、何かをインストールする必要がありますか?
いいえ。お客様は、これまでどおり WhatsApp、Instagram の DM、Messenger、またはコメントで企業に連絡します。御社のエージェントが同じチャネルで返信します。
顧客の担当者は、引き続き手動で返信できますか?
はい。Coexistence では、同じ番号で WhatsApp Business アプリが引き続き使えます。担当者が送るメッセージはすべてエコーとして御社の Webhook に届くため、エージェントは対応を譲れます。
easyCoexistence はモデルを動かしますか?
いいえ。モデル、そのプロンプト、そのメモリは御社のバックエンドで動きます。easyCoexistence はアカウントを接続し、そのイベントを配信し、アクセスを維持します。
エージェント SaaS の顧客一人あたり、easyCoexistence の料金はいくらですか?
接続済みの番号またはアカウント 1 件あたり月額 US$ 9 から、総数が増えるほど下がり US$ 0.75 まで。WhatsApp と Instagram を使う顧客は二件分として数えられます。最初の 3 日間は無料です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日