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

AI agent SaaS 架構:在 WhatsApp、Instagram 與 TikTok 上觸達你客戶的客戶

能夠觸達你客戶的客戶的 AI agent SaaS 分為五層:連接層,客戶在此透過 easyCoexistence 的 Partner API 連結 WhatsApp、Instagram、TikTok 及更多渠道;接收層,負責驗證並將 webhook 排入隊列;你擁有的對話儲存;運行你模型的 agent 工作程式;以及發送層,透過各網絡的官方 API 回覆、發布並追蹤狀態事件。

smb_message_echoes

描述商家透過 Coexistence 號碼上的 WhatsApp Business 應用程式所發出訊息的 webhook。

7 days

Meta 會重試你端點未接受的 WhatsApp webhook 多久,這可能令同一則訊息送達兩次。

1 attempt

每則轉發的 Instagram、Facebook 或 TikTok 事件的送達次數,不作重試,亦不保留副本。

24 hours

客戶傳來訊息後的 WhatsApp 客戶服務時限;時限以外,商家只可發送已核准的訊息範本。

20 mps

同時用於 WhatsApp Business 應用程式與 Cloud API 的號碼,其固定吞吐量。

AI agent SaaS 有哪些層次?

共五層,每層只負責一項工作,因此模型運行緩慢時不會遺失訊息,帳戶失效時也不會令整個產品停擺。easyCoexistence 位於首層與末層:負責連接帳戶並維持其運作,而對話邏輯與模型則留在你的後端。

1ConnectionsHosted links, channel_id and connection_id per customer
2IngestionVerify, queue, then answer 2xx
3ConversationsYour store, one thread per person
4AgentYour model, prompts and tools
5OutboundReplies, posts and status events

如何為租戶、渠道與對話建模?

使用三個資料表。租戶即你的客戶,其 id 會以 external_ref 送出於每個連接會話中,使每個連接與狀態事件返回時都帶有此標記。渠道資料列儲存 WhatsApp 號碼的 connection_id 或社交帳戶的 channel_id,並記錄其網絡與狀態。對話以渠道,加上該人士在該網絡上的 ID 作為鍵:WhatsApp 的 from 號碼、Instagram 私訊中的 Instagram 範圍 ID,或 TikTok 留言串。

傳入事件應先落在哪裡?

應先進入持久隊列,然後才運行任何模型。接收端點會檢查 WhatsApp 傳送中 URL 路徑內的密鑰,以及轉發社交事件中的 X-EC-Signature,將事件寫入隊列並回覆 2xx。兩個來源的行為不同:Meta 會把 WhatsApp webhook 重試最多 7 天,因此同一則訊息可能抵達兩次;而轉發的 Instagram、Facebook 或 TikTok 事件只發送一次且不作保留,被你的端點拒絕的事件便會遺失。請以網絡本身的訊息或留言 ID 進行去重。

如何令回覆保持順序與準時?

每個對話設一個工作程式,並於每次發送前作檢查。agent 運作時鎖定該對話,使同一人的兩則訊息依序回覆,且絕不重複。WhatsApp 回覆發出前,須將該人士最後一則訊息與 24 小時時限作比對,時限結束後改用已核准的訊息範本。每個號碼的發送須排隊,速率最高為每秒 20 則,即 Coexistence 號碼的固定速率;同時請記住,TikTok 回覆屬於公開留言。

人工如何接手 agent 的工作?

透過渠道本身。使用 Coexistence 時,客戶的職員可繼續在同一號碼上使用 WhatsApp Business 應用程式,其每則發出的訊息都會以 smb_message_echoes 形式抵達你的 webhook。請將回聲視為交接:暫停該對話的 agent,將職員的回覆作為上下文交給模型,並於一段靜默時段後,或職員於你的產品中將其交還時恢復。Instagram 也會把帳戶本身的私訊以回聲形式返回,因此同一規則可防止 agent 回覆自己。

agent 可否同時發布貼文?

可以,透過同一套連接。agent 草擬貼文,你的後端再以 POST /channels/:id/posts 將其排入隊列,發布至 Instagram、Facebook、TikTok 及 LinkedIn,可提前 1 分鐘至 90 天排程,並透過 post.published 與 post.failed 將結果回報至對話儲存。LinkedIn 貼文須在你的產品中經人工逐篇核准後才會發出,因為 LinkedIn 的 API 條款限制自動發文。

連接中斷時,產品如何反應?

透過渠道資料列的狀態。狀態事件會將其更改為 disconnected、removed 或 suspended,agent 停止在該渠道發送,你的介面則要求租戶透過新的連接會話重新連接。connection.token_missing 事件會令號碼仍可接收但無法發送,因此 agent 改為替職員草擬回覆。connection.connected 或 channel.connected 會把資料列設回 active,工作程式於下次回覆前取得新憑證。

你儲存哪些數據,easyCoexistence 又保存哪些?

你的產品儲存對話。WhatsApp 號碼的訊息由 Meta 直接傳送至你的 webhook,而轉發的社交事件則經 easyCoexistence 傳送,不作副本。easyCoexistence 只保留服務該連接所需的內容:帳戶紀錄、其憑證、健康狀態歷史,以及其發布的貼文。若你的帳戶同時開啟 easyCoexistence 自有的自動化功能,其訊息內容會保留 7 天,運行紀錄則保留 30 天。

常見錯誤

  • 僅以人的電話號碼作為對話鍵。同一人可以向你的兩個租戶發送訊息,因此請以渠道與該人士的 ID 共同作為每個對話的鍵。
  • 讓兩個工作程式回覆同一對話。並行工作程式可能令回覆次序錯亂或重複發送,因此 agent 處理期間須鎖定每個對話。
  • 職員透過 WhatsApp Business 應用程式回覆後仍讓 agent 繼續運作。回聲顯示有人已接手該對話,因此須在此暫停 agent,直至你的交接規則將其交還。
  • 以計時器自動發布 agent 草擬的 LinkedIn 貼文。LinkedIn 每篇貼文均須人工核准,因此應先將這些草稿送入審核步驟,然後才進入隊列。
使用 EasyCoexistence 完成這項設定

easyCoexistence 是你 agent 產品的連接層:你客戶的 WhatsApp 號碼,以及其 Instagram、Facebook、TikTok、YouTube 與 LinkedIn 帳戶,還有更多渠道,均透過託管連結連接,並附有新鮮憑證、webhook、發布隊列與已簽署的狀態事件,每個連接全天候 24/7 監察。每個連接每月由 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。

常見問題

你客戶的客戶需要安裝任何程式嗎?

不需要。他們一如既往在 WhatsApp、Instagram 私訊、Messenger 或留言區向商家發訊,你的 agent 便會在同一渠道回覆。

客戶的職員可以繼續親自回覆嗎?

可以。使用 Coexistence 時,WhatsApp Business 應用程式會在同一號碼上繼續運作,職員發出的每則訊息都會以回聲形式抵達你的 webhook,因此 agent 可以退讓。

easyCoexistence 會運行模型嗎?

不會。模型、其提示詞與記憶均在你的後端運行。easyCoexistence 負責連接帳戶、傳送其事件並維持其存取權正常。

easyCoexistence 對 agent SaaS 的每位客戶如何收費?

每個已連接的號碼或帳戶每月由 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,因此同時使用 WhatsApp 與 Instagram 的客戶會計為兩項。首 3 天免費。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期