如何取得客戶的 WhatsApp、Instagram 及 TikTok API 權杖
easyCoexistence 的 Partner API 只需一次 GET 加上 ?credentials=1,便會返回已連接客戶的 API 權杖及 ID。若為 WhatsApp 號碼,/connections/{id} 會提供 waba_id、phone_number_id、Graph API 基礎網址、發送端點,以及客戶自己的業務權杖。若為社交帳戶,/channels/{id} 會提供該網絡的 API 基礎網址、帳戶在該網絡的 ID,以及為你續期的存取權杖,因此請於每個工作開始時取得。
為 WhatsApp 號碼的 GET /connections/{id},以及社交帳戶的 GET /channels/{id},加入 credentials。
Google 使用者存取權杖的有效期,即 YouTube 頻道 API 呼叫所用的那種權杖。
來自 API for Business 的 TikTok 帳戶存取權杖有效期;其刷新權杖有效一年。
長效 Instagram 權杖刷新後的有效期,由刷新當日起計。
Meta 的長效 Page 存取權杖並無到期日,不過若干情況下可能會失效。
哪個呼叫會返回連接的憑證?
使用資源本身的 GET,並附上 ?credentials=1,以 ec_live_ 金鑰作為 Bearer 權杖驗證。WhatsApp 號碼位於 /connections/{id},社交帳戶位於 /channels/{id},兩者各自擁有獨立的 ID 命名空間:連接重定向會為號碼返回 connection_id,為社交帳戶返回 channel_id。GET /connections 與 GET /channels 會列出相關項目,而 ?external_ref= 可將任一列表篩選至單一客戶。若不加此參數,同一呼叫只會返回不含權杖的連接。
# A WhatsApp number
curl "https://easycoexistence.com/api/v1/connections/$CONNECTION_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# A social account
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"WhatsApp 號碼的憑證呼叫會返回什麼?
連接本身,加上一個 credentials 物件。waba_id 與 phone_number_id 在 Meta 的 Graph API 上分別識別 WhatsApp Business 帳戶及該號碼,token_ready 則說明是否已存有客戶權杖。在 credentials 之內,graph_api_base 與 send_endpoint 已包含 Graph API 版本,而 access_token 則是客戶連接時 Meta 發出的業務權杖,範圍僅限該客戶。之後,你的後端會直接呼叫 Meta 進行發送、管理範本、上載媒體及編輯業務檔案。
- status:connected、degraded、disconnected、banned、suspended、removed 或 unknown。
quality_rating與messaging_tier:Meta 的評級,例如 GREEN,以及號碼的層級,例如TIER_1K。webhook_url:Meta 發送該號碼訊息的目的地,或為 null。disconnected_reason、last_checked_at、last_event_at與created_at:若已有記錄,則為 Meta 的斷開原因,以及 ISO 8601 格式的時間戳記。
{
"id": "<CONNECTION_ID>",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"phone": "+55 11 9…",
"name": "Clínica Sorriso",
"waba_id": "<WABA_ID>",
"phone_number_id": "<PHONE_NUMBER_ID>",
"status": "connected",
"quality_rating": "GREEN",
"messaging_tier": "TIER_1K",
"platform_type": "…",
"token_ready": true,
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"disconnected_reason": null,
"last_checked_at": "2026-10-31T09:00:00.000Z",
"last_event_at": "2026-10-31T08:41:12.000Z",
"created_at": "2026-10-20T14:03:55.000Z",
"credentials": {
"graph_api_base": "https://graph.facebook.com/v25.0",
"send_endpoint": "https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages",
"access_token": "EAAG…",
"note": "The customer's own business token, scoped to their assets. …"
}
}各社交網絡的憑證呼叫會返回什麼?
渠道的檢視,與 GET /channels/{id} 相同,包括 id、channel、external_ref、name、username、external_id、status 與 token_ready,另加一個 credentials 物件。各網絡的 credentials 均包含 platform、API 基礎網址、帳戶在該網絡上的 ID、access_token、token_expires_at、token_note 及示例呼叫。ID 欄位,以及各網絡所需的其他欄位,則各有不同:
為何要逐次任務取得社交權杖,而不是存起來?
因為部分權杖會於一天內輪替,而憑證呼叫總是返回此刻有效的權杖。YouTube 的 Google 權杖有效一小時,TikTok 的則為一天,easyCoexistence 會在兩者到期前續期。Instagram 的權杖有效 60 天,並會在期限屆滿前及早刷新,過程中會發出新權杖。只要 Facebook Page 維持連接,其權杖便不會到期。每個工作開始時發出一次請求,可確保你的程式永遠不會以已失效的權杖呼叫網絡。
是否應該儲存 WhatsApp 號碼的權杖?
應該。此為 Meta 的 Embedded Signup 所發出的業務權杖,Meta 將其範圍限於該已完成加入的客戶,參考文件要求你在自己的系統內儲存,因為控制台不會顯示。每次 connection.connected 事件後請重新讀取,因為重新連接可能會發出新權杖。若號碼被暫停或移除,其權杖將不再提供;而若 Meta 不再接受某客戶權杖,但號碼仍有回應,該權杖便會被停用,令 token_ready 變為 false。
token_ready 與 token_missing 是什麼意思?
當客戶權杖已存在且連接處於運作中時,token_ready 為 true。號碼在連接後可能暫時為 false,因為 Meta 有時會在未發出客戶權杖的情況下完成 Embedded Signup。此時託管頁面會要求客戶再完成一次,而你的事件端點會收到 connection.token_missing。若客戶略過此步驟,號碼雖可接收訊息(因其 ID 有效),卻無法發送。為該客戶建立新的連接會話時會發出權杖,但絕不會取代已能正常運作的權杖。社交渠道沒有 token_missing:其登入必定會取得客戶自己的權杖,因此 token_ready 跟隨 status。
連接沒有權杖可提供時,會返回什麼?
返回 200,其 credentials 中的 access_token 為 null,並附有說明後續步驟的備註,而非錯誤。這包括 token_ready 為 false 的號碼、已暫停或已移除的號碼,以及狀態非 connected 的渠道;此時備註會要求建立新的連接會話。404 not_found 表示該 ID 不屬於你的帳戶;502 credentials_unavailable 則表示當時無法取得新的社交權杖,請重試,若重複出現,請檢查該渠道的狀態。
常見錯誤
- 將 YouTube 或 TikTok 的權杖快取於設定檔內。這些權杖分別在一小時和一天內到期,因此請於每個工作開始時呼叫憑證端點,並把續期交由 easyCoexistence 處理。
- 從 token_ready 為 false 的號碼發送。該號碼沒有可用於呼叫 Meta 的客戶權杖;請為該客戶開啟新的連接會話,以取得權杖。
- 以 Authorization 標頭呼叫 TikTok。其 Business API 會以 Access-Token 標頭傳遞權杖,並且每個請求都須帶上帳戶的 business_id。
- 只以 Bearer 權杖呼叫 LinkedIn。LinkedIn 還需要 required_headers 內列出的 LinkedIn-Version 與 X-Restli-Protocol-Version 標頭,且路徑中的 URN 須經 URL 編碼。
easyCoexistence 為你的客戶連接 WhatsApp 號碼,以及其 Instagram、Facebook、TikTok、YouTube 與 LinkedIn 帳戶,並會加入更多渠道。你的後端可隨時索取每個連接的憑證,社交權杖會獲自動續期,而每個連接均獲 24/7 監察。每個連接每月由 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。
常見問題
WhatsApp 權杖是客戶自己的嗎?
是。這是客戶透過 Embedded Signup 連接時,Meta 發出的業務權杖,範圍限於該客戶。easyCoexistence 的系統權杖從不外露,而只有在 token_ready 為 true 時,呼叫才會返回權杖。
社交存取權杖的有效期有多長?
YouTube 的權杖有效一小時,TikTok 的有效一天,Instagram 的最長 60 天,而 Facebook Page 權杖不會到期。easyCoexistence 會為會輪替的權杖續期,因此每次憑證呼叫都會返回此刻可用的權杖。
我是否需要在各網絡上建立自己的開發者應用程式?
不需要。客戶透過 easyCoexistence 自己的應用程式在 Meta、TikTok、Google 及 LinkedIn 登入,而憑證呼叫會向你的後端提供權杖,讓你直接呼叫該網絡的 API。
Claude 或 ChatGPT 等助理能否讀取相同的憑證?
可以。透過 MCP 伺服器登入你的帳戶後,它便可為號碼呼叫 get_api_credentials,為社交帳戶呼叫 get_social_credentials,返回的憑證與 Partner API 相同。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期