顧客の WhatsApp、Instagram、TikTok で AI エージェント製品を構築する方法
顧客のチャネルで動く AI エージェント製品は、3 つの要素で成り立ちます。1 つ目は、顧客それぞれの WhatsApp 番号や SNS アカウントを接続するためのホステッド接続リンクです。2 つ目は、メッセージやコメントをバックエンドに届ける Webhook です。3 つ目は、バックエンドで独自モデルが返信を作成し、顧客のトークンを使って各ネットワークの公式 API から送信する仕組みです。さらに、切断された接続はステータスイベントで通知されます。エージェントは、WhatsApp の 24 時間ウィンドウなど、各ネットワークのルールを守ります。
easyCoexistence は、顧客の WhatsApp 番号と、Instagram、Facebook、TikTok、YouTube、LinkedIn のアカウントで、製品の AI エージェントに顧客との接点を与えます。
WhatsApp のカスタマーサービスウィンドウは、ユーザーのメッセージまたは通話の後に開きます。新しいメッセージが届くたびにリセットされます。
WhatsApp の事業者が、カスタマーサービスウィンドウを過ぎた後に送れるのは、事前承認済みのテンプレートメッセージだけです。
Meta の規約は、AI プロバイダーが WhatsApp を使い、副次的ではなく主要な機能として AI を提供することを禁じています。
Instagram アカウントが、コメントへの非公開返信を 1 回だけ送れる期間。コメントが投稿された時点から数えます。
Cloud API と WhatsApp Business アプリの両方で使う番号の、固定のスループット。
顧客のチャネルに、AI エージェント製品は何を必要としますか?
必要なものは 4 つです。顧客が接続するための手段、メッセージをバックエンドに届ける経路、返信に使うトークン、そして接続が停止したときの通知です。Partner API はこれらすべてを提供し、モデル、プロンプト、会話ロジックは、ご自身で管理します。easyCoexistence はアカウントを接続し、アクセスを更新し続けて監視します。返信は、バックエンドからネットワークの API へ直接送られます。
顧客それぞれは、どのように接続しますか?
バックエンドで POST /connect-sessions を呼び出し、チャネル、redirect_url、顧客を識別する external_ref を指定して接続セッションを作成します。番号の場合は webhook_url と webhook_verify_token も指定します。顧客はホステッドリンクを開き、Meta、TikTok、Google、LinkedIn でサインインして、connection_id または channel_id を付けてアプリに戻ります。easyCoexistence のアカウント、メールアドレス、カードは不要です。お客様のキーを通じて作成された接続はすべて、お客様のアカウントに属します。
メッセージやコメントは、どのようにモデルに届きますか?
Webhook により、送信に対応するネットワークから届きます。Meta は番号宛てのメッセージを webhook_url に直接送信し、事業者のスタッフが WhatsApp Business アプリから送ったメッセージは smb_message_echoes として届きます。Instagram と Facebook のコメント、メンション、DM、そして TikTok のコメントは、各チャネルの送信先に、そのシークレットで署名されて転送されます。YouTube と LinkedIn はコメントのイベントを送信しないため、エージェントはスケジュールに従って API から新しいコメントを読み取ります。各配信には直ちに 2xx で応答し、モデルの呼び出しはワーカーに任せてください。
エージェントは、どのように返信しますか?
ネットワーク自身の API を通じて、バックエンドが取得した認証情報を使って返信します。WhatsApp の返信は、顧客のトークンを付けて番号の send_endpoint へ POST します。Instagram または Facebook の DM は、アカウントの messages エッジへ送られます。TikTok の返信は、business/comment/reply/create/ を使ってコメントの下に投稿されます。以下の例は WhatsApp メッセージへの返信を示しています。URL パスのシークレットを検証し、受信した各メッセージをキューに入れて、モデルが返したものを返信として送ります。
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request
EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"} # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"] # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {} # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)
@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
if not hmac.compare_digest(secret, PATH_SECRET):
abort(404)
if request.method == "GET": # Meta's handshake when the destination is set
if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
abort(403)
return request.args.get("hub.challenge", "")
for entry in request.get_json().get("entry", []):
for change in entry.get("changes", []):
if change.get("field") == "messages": # echoes and history are context, not prompts
value = change["value"]
for msg in value.get("messages", []):
jobs.put((value["metadata"]["phone_number_id"], msg))
return "", 200 # answer at once; dedupe on msg["id"], since Meta can deliver twice
def worker() -> None:
while True:
phone_number_id, msg = jobs.get()
conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
headers=KEY, params={"credentials": 1}).json()
creds = conn["credentials"]
if not creds["access_token"]: # token_ready is false: a new connect session issues one
continue
reply = my_model(conn["external_ref"], msg) # your model, your prompt, your memory
requests.post(creds["send_endpoint"], # a reply to a fresh message is inside the 24 hours
headers={"Authorization": f"Bearer {creds['access_token']}"},
json={"messaging_product": "whatsapp", "to": msg["from"],
"type": "text", "text": {"body": reply}})
threading.Thread(target=worker, daemon=True).start()エージェントは MCP サーバーと Partner API のどちらを使いますか?
Partner API です。エージェントがお客様の製品で、顧客がチャネルを持ち込む場合に使います。バックエンドがキーを保持し、イベントを受け取り、お好きなモデルを実行できます。MCP サーバー(https://easycoexistence.com/api/mcp)は、Claude や ChatGPT のようなアシスタントが、お客様ご自身の easyCoexistence アカウントで動作する場合に適しています。OAuth サインイン後に、アシスタントが必要に応じて呼び出すツールを通じて利用します。お客様のキーで接続された番号とチャネルも同じアカウントに属するため、MCP セッションは社内の作業のために、それらにアクセスできます。
| Partner API | MCP server | |
|---|---|---|
| Built for | Your product, serving your customers | An assistant working on your own account |
| Signs in with | An ec_live_ key, one per account | OAuth, from Claude, ChatGPT or another client |
| Incoming messages | Webhooks to your backend | Read when the assistant calls a tool |
| The model | Any model you run | The assistant's own |
| Replies | Your code calls each network's API | Tools such as send_message and reply_to_comment |
代理店は、多数のクライアント向けにエージェントをどう運用しますか?
1 つのアカウントで、各クライアントにタグを付けて運用します。すべての接続セッションに、クライアントの ID を external_ref として渡し、partner_name で代理店名をホステッドページに表示させます。1 クライアントの接続は、GET /connections?external_ref= と GET /channels?external_ref= で一覧表示できます。各接続は代理店に対して、接続ごとに月額 US$ 9 から、接続を追加するほど下がって US$ 0.75 まで課金されます。一方、WhatsApp の会話料金は Meta から、クライアント自身の WhatsApp Business アカウントに請求されます。Coexistence を使えば、クライアントのスタッフは、エージェントと並行して WhatsApp Business アプリで返信を続けられます。
エージェントが守るべきルールは何ですか?
各ネットワーク自身のルールです。モデルの返信を送信する前に、コードでこれらを確認してください。Meta の措置は顧客のアカウントに及ぶため、プラットフォームは顧客に代わってこれらのルールを守る必要があります。
- WhatsApp: 自由形式の返信は、顧客の最後のメッセージから 24 時間以内に限られます。それ以降は、承認済みのテンプレートを API 経由で送信します。Coexistence では WhatsApp Business アプリからテンプレートを送信できないためです。
- WhatsApp: Meta の規約は、AI を主要な機能として提供することを禁じています。Partner API のリファレンスでは、汎用 AI ボットは不可とされています。また、WhatsApp のデータによるファインチューニングは、事業者の独占的な利用に限り許可されています。
- Instagram と Facebook: DM は相手の最後のメッセージから 24 時間以内に限られ、コメントへの非公開返信は、そのコメントから 7 日以内に 1 件だけ送れます。
- TikTok: コメントへの返信は公開されます。TikTok の接続には DM がないためです。
- 送信量: Coexistence の番号 1 件につき、毎秒 20 件まで。マーケティングテンプレートには、顧客の WhatsApp Business アカウントに支払い方法の登録が必要です。
エージェントは、チャネルが停止したことをどう把握しますか?
ステータスイベントで把握します。connection.disconnected または channel.disconnected は、顧客が再接続するまで返信が失敗することを意味します。その場合は、顧客のエージェントを一時停止して顧客に知らせ、新しい接続リンクを送ってください。connection.token_missing は、番号が受信はできても、送信はまだできない状態を意味します。connection.connected または channel.connected が再び届いたら、新しい認証情報を取得して再開します。各イベントは X-EC-Signature で署名され、約 33 時間にわたって再送されます。
よくある間違い
- 24 時間より古い WhatsApp メッセージに、モデルがフリーテキストで答えさせること。ウィンドウはすでに閉じているため、顧客の最後の受信時刻を確認し、承認済みテンプレートに切り替えてください。
- 共有モデルを、顧客の WhatsApp 会話で学習させること。Meta の規約は、WhatsApp Business Platform のデータによるファインチューニングを、事業者の独占的な利用に限って許可しています。他のモデルの改善に使うことは許されません。
- smb_message_echoes を顧客のメッセージとして扱うこと。これは事業者のスタッフがアプリから送った内容なので、返信すべきメッセージではなく、モデルに渡す文脈として使ってください。
- アカウント自身の返信に返信してしまうこと。アカウントが送った Instagram の DM はエコーとして、TikTok の返信はコメントイベントとして戻ってきます。アカウント自身が書いたものはスキップしてください。そうしないと、エージェントが自分に返信し続けてしまいます。
さらに対応チャネルを増やしていきます。ホステッド接続リンク、新しい認証情報、Webhook、署名付きステータスイベントを各ネットワークの公式 API 上で提供し、すべての接続を 24 時間体制で監視します。接続ごとに月額 US$ 9 から、接続を追加するほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
独自の AI モデルを使えますか?
はい。バックエンドがメッセージを受け取り、お好きなモデルを呼び出して、顧客のトークンを使ってネットワークの API から返信します。WhatsApp 番号のメッセージは Meta から直接 Webhook に届き、easyCoexistence を経由することはありません。
WhatsApp のエージェントに、Meta の AI ポリシーはどう関係しますか?
Meta の規約は、AI プロバイダーが WhatsApp Business Platform を使い、Meta の判断により、副次的または付随的ではなく主要な機能として AI 技術を提供することを禁じています。顧客に代わって、24 時間ウィンドウや承認済みテンプレートとあわせて、この規約を守ってください。
エージェントは TikTok、YouTube、LinkedIn で DM を送れますか?
いいえ。これらのネットワークでは、エージェントはコメント上で動作します。TikTok の返信は公開されます。YouTube と LinkedIn のコメントは、各 API を通じて読み取り、返信されます。
AI エージェント製品に easyCoexistence はいくらかかりますか?
料金はどのネットワークでも接続ごとに同じです。接続ごとに月額 US$ 9 から、接続を追加するほど下がり US$ 0.75 まで。最初の 3 日間は無料です。Meta の WhatsApp 会話料金は、各顧客自身の WhatsApp Business アカウントに請求されます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日