登入開始免費試用
easyCoexistence 官方 API

如何在客戶的 WhatsApp、Instagram 和 TikTok 上建立 AI 代理產品

在客戶頻道上運作的 AI 代理產品,由三部分組成:為每個客戶的 WhatsApp 號碼或社交帳戶提供的託管連接鏈接;透過 Webhook 把客戶的訊息和留言傳送到您的後端,由您自己的模型撰寫回覆,並以客戶的存取權杖經各平台官方 API 發送;以及連接中斷時的狀態事件。代理會遵守各平台的規則,例如 WhatsApp 的 24 小時服務窗口。

easyCoexistence 讓您產品的 AI 代理,在客戶的 WhatsApp 號碼,以及其 Instagram、Facebook、TikTok、YouTube 和 LinkedIn 帳戶上發聲,並會陸續加入更多頻道。

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 完成這項設定

服務包括託管連接鏈接、更新的憑證、Webhook 及已簽署的狀態事件,全部經各平台官方 API 運作,每個連接全天候 24/7 監察。每月每個連接由 US$ 9 降至 US$ 0.75,連接越多單價越低,前 3 天免費試用。

常見問題

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

可以。您的後端接收訊息,呼叫您選擇的任何模型,並以客戶的存取權杖透過各平台 API 回覆。WhatsApp 號碼的訊息由 Meta 直接送到您的 Webhook,不會經過 easyCoexistence。

Meta 的 AI 政策對 WhatsApp 代理有何影響?

Meta 的條款禁止 AI 供應商利用 WhatsApp Business Platform 提供 AI 技術作為主要功能,而非附帶或輔助功能,由 Meta 認定。您應代表客戶遵守,並遵守 24 小時窗口及已批准範本的規定。

AI 代理可否在 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 監察

驗證日期