ログイン無料トライアルを開始
easyCoexistence 公式 API

顧客の WhatsApp、Instagram、TikTok で AI エージェント製品を構築する方法

顧客のチャネルで動く AI エージェント製品は、3 つの要素で成り立ちます。1 つ目は、顧客それぞれの WhatsApp 番号や SNS アカウントを接続するためのホステッド接続リンクです。2 つ目は、メッセージやコメントをバックエンドに届ける Webhook です。3 つ目は、バックエンドで独自モデルが返信を作成し、顧客のトークンを使って各ネットワークの公式 API から送信する仕組みです。さらに、切断された接続はステータスイベントで通知されます。エージェントは、WhatsApp の 24 時間ウィンドウなど、各ネットワークのルールを守ります。

easyCoexistence は、顧客の WhatsApp 番号と、Instagram、Facebook、TikTok、YouTube、LinkedIn のアカウントで、製品の AI エージェントに顧客との接点を与えます。

24 hours

WhatsApp のカスタマーサービスウィンドウは、ユーザーのメッセージまたは通話の後に開きます。新しいメッセージが届くたびにリセットされます。

Templates only

WhatsApp の事業者が、カスタマーサービスウィンドウを過ぎた後に送れるのは、事前承認済みのテンプレートメッセージだけです。

Section 4.7

Meta の規約は、AI プロバイダーが WhatsApp を使い、副次的ではなく主要な機能として AI を提供することを禁じています。

7 days

Instagram アカウントが、コメントへの非公開返信を 1 回だけ送れる期間。コメントが投稿された時点から数えます。

20 mps

Cloud API と WhatsApp Business アプリの両方で使う番号の、固定のスループット。

顧客のチャネルに、AI エージェント製品は何を必要としますか?

必要なものは 4 つです。顧客が接続するための手段、メッセージをバックエンドに届ける経路、返信に使うトークン、そして接続が停止したときの通知です。Partner API はこれらすべてを提供し、モデル、プロンプト、会話ロジックは、ご自身で管理します。easyCoexistence はアカウントを接続し、アクセスを更新し続けて監視します。返信は、バックエンドからネットワークの API へ直接送られます。

1ConnectA hosted link per customer: POST /connect-sessions
2ReceiveMessages from Meta; comments and DMs forwarded, signed
3DecideYour model, your prompts, your memory
4ReplyThe network's API, with the customer's token
5Watchconnection.* and channel.* status events

顧客それぞれは、どのように接続しますか?

バックエンドで 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 パスのシークレットを検証し、受信した各メッセージをキューに入れて、モデルが返したものを返信として送ります。

Python: a WhatsApp agent on your own model
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 APIMCP server
Built forYour product, serving your customersAn assistant working on your own account
Signs in withAn ec_live_ key, one per accountOAuth, from Claude, ChatGPT or another client
Incoming messagesWebhooks to your backendRead when the assistant calls a tool
The modelAny model you runThe assistant's own
RepliesYour code calls each network's APITools 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 の返信はコメントイベントとして戻ってきます。アカウント自身が書いたものはスキップしてください。そうしないと、エージェントが自分に返信し続けてしまいます。
EasyCoexistence で実現する

さらに対応チャネルを増やしていきます。ホステッド接続リンク、新しい認証情報、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 監視

確認日