登录开始免费试用
easyCoexistence 官方 API

如何在客户的 WhatsApp、Instagram 和 TikTok 上构建 AI 代理产品

客户渠道上的 AI 代理产品由三部分组成:为每位客户的 WhatsApp 号码或社交账户提供的托管连接链接;通过 Webhook 将消息和评论传到您的后端,由您自己的模型生成回复,并使用客户的访问令牌,经各平台的官方 API 发出;以及连接中断时的状态事件。代理会遵守各平台的规则,例如 WhatsApp 的 24 小时窗口。

easyCoexistence 让您产品中的 AI 代理能够在客户的 WhatsApp 号码,以及其 Instagram、Facebook、TikTok、YouTube 和 LinkedIn 账户上发声,并支持更多渠道:提供托管连接链接、最新凭证、Webhook 以及经签名的状态事件,均基于各平台的官方 API,每个连接全天候 24/7 监控。

24 hours

用户发送消息或来电后,WhatsApp 客户服务窗口随即开启;每条新消息都会重置该窗口。

Templates only

WhatsApp 客户服务窗口关闭后,企业只能发送预先批准的消息模板。

Section 4.7

Meta 的条款禁止 AI 服务商利用 WhatsApp 提供主要而非附带性的 AI 功能。

7 days

Instagram 账户对单条评论的一次私信回复时限,自评论发布之时起算。

20 mps

同时使用 WhatsApp Business 应用和 Cloud API 的号码,吞吐量是固定的。

AI 代理产品需要从每位客户的渠道获得什么?

四样东西:客户连接渠道的方式、消息送达您后端的通道、用于回复的令牌,以及连接停止工作时的通知。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 的评论、提及与私信,以及 TikTok 的评论,会被转发到各渠道的目标地址,并使用其密钥签名。YouTube 和 LinkedIn 不发送评论事件,因此代理会按计划通过其 API 读取新评论。请立即以 2xx 响应每次投递,再由工作进程调用模型。

代理如何回复?

通过各平台自己的 API 回复,使用您的后端获取的凭证。WhatsApp 回复是向号码的 send_endpoint 发送 POST 请求,并附上客户的令牌;Instagram 或 Facebook 私信发往账户的 messages edge;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:您的后端持有密钥、接收事件,并可运行您选择的任何模型。位于 https://easycoexistence.com/api/mcp 的 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

代理服务机构如何为众多客户运行代理?

在一个账户下运行,并为每位客户加上标签。在每个连接会话中以 external_ref 传入客户 ID,用 partner_name 在托管页面上显示您机构的名称,并使用 GET /connections?external_ref= 和 GET /channels?external_ref= 列出某位客户的连接。连接费用按月计入机构账单,每个连接每月 US$ 9 至 US$ 0.75,连接越多单价越低;而 Meta 将 WhatsApp 对话费用计入客户自己的 WhatsApp Business 账户。在使用 Coexistence 时,客户员工仍可在 WhatsApp Business 应用中与代理并行回复。

代理必须遵守哪些规则?

平台自身的规则,您的代码应在模型回复发出前进行检查。平台代表其客户执行这些规则,因为 Meta 的执法会落在客户账户上:

  • WhatsApp:仅在客户最后一条消息后的 24 小时内可发送自由格式回复;此后只能发送已批准的模板,并通过 API 发送,因为 WhatsApp Business 应用在 Coexistence 下无法发送模板。
  • WhatsApp:Meta 的条款禁止将 AI 作为主要功能提供,Partner API 参考文档明确不允许通用 AI 机器人;条款仅允许企业为其专属用途,在 WhatsApp 数据上进行微调。
  • Instagram 和 Facebook:私信须在对方最后一条消息后的 24 小时内发送;每条评论只能私下回复一次,且须在评论发布后 7 天内完成。
  • TikTok:对评论的回复是公开的,因为 TikTok 连接没有私信功能。
  • 流量:每个 Coexistence 号码每秒 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 私信会以回声形式返回,TikTok 回复则以评论事件返回,因此应跳过账户本人撰写的内容,否则代理会回复自己。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 至 US$ 0.75,随连接增加而递减,前 3 天免费。

常见问题

我可以使用自己的 AI 模型吗?

可以。您的后端接收消息,调用您选择的任何模型,并使用客户的令牌通过平台 API 回复。WhatsApp 号码的消息由 Meta 直接发送到您的 Webhook,不会经过 easyCoexistence。

Meta 的 AI 政策对 WhatsApp 代理意味着什么?

Meta 的条款禁止 AI 服务商利用 WhatsApp Business Platform 提供 AI 技术,且该功能须为主要功能,而非附带性或辅助性功能,具体由 Meta 认定。请代表您的客户遵守该规定,并遵守 24 小时窗口和已批准模板的要求。

代理能否在 TikTok、YouTube 或 LinkedIn 上发送私信?

不能。在这些平台上,代理仅在评论区工作:TikTok 的回复是公开的,YouTube 和 LinkedIn 的评论则通过其 API 读取并回复。

easyCoexistence 的 AI 代理产品费用是多少?

按连接计费,各平台标准一致:每个连接每月 US$ 9 至 US$ 0.75,随连接增加而递减,前 3 天免费。Meta 将 WhatsApp 对话费用计入每位客户自己的 WhatsApp Business 账户。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间