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

如何取得客戶的 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,以及為你續期的存取權杖,因此請於每個工作開始時取得。

?credentials=1

為 WhatsApp 號碼的 GET /connections/{id},以及社交帳戶的 GET /channels/{id},加入 credentials。

1 hour

Google 使用者存取權杖的有效期,即 YouTube 頻道 API 呼叫所用的那種權杖。

1 day

來自 API for Business 的 TikTok 帳戶存取權杖有效期;其刷新權杖有效一年。

60 days

長效 Instagram 權杖刷新後的有效期,由刷新當日起計。

No expiry

Meta 的長效 Page 存取權杖並無到期日,不過若干情況下可能會失效。

哪個呼叫會返回連接的憑證?

使用資源本身的 GET,並附上 ?credentials=1,以 ec_live_ 金鑰作為 Bearer 權杖驗證。WhatsApp 號碼位於 /connections/{id},社交帳戶位於 /channels/{id},兩者各自擁有獨立的 ID 命名空間:連接重定向會為號碼返回 connection_id,為社交帳戶返回 channel_id。GET /connections 與 GET /channels 會列出相關項目,而 ?external_ref= 可將任一列表篩選至單一客戶。若不加此參數,同一呼叫只會返回不含權杖的連接。

Credentials for a number and for a social account
# 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 格式的時間戳記。
GET /connections/{id}?credentials=1
{
  "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 欄位,以及各網絡所需的其他欄位,則各有不同:

Instagramgraph_api_base https://graph.instagram.com/v25.0 and account_id_on_meta, the Instagram account's ID. A user token, refreshed before its 60 days run out.
Facebookgraph_api_base https://graph.facebook.com/v25.0 and account_id_on_meta, the Page ID. A Page token that does not expire while the Page stays connected.
TikTokapi_base https://business-api.tiktok.com/open_api/v1.3 and business_id. A day-long token, sent in an Access-Token header with business_id on each call.
YouTubeapi_base https://www.googleapis.com/youtube/v3, analytics_api_base for YouTube Analytics v2, and channel_id. An hour-long Google token, sent as a bearer token.
LinkedInapi_base https://api.linkedin.com/rest, author_urn for the Page or profile, and required_headers with LinkedIn-Version and X-Restli-Protocol-Version 2.0.0.

為何要逐次任務取得社交權杖,而不是存起來?

因為部分權杖會於一天內輪替,而憑證呼叫總是返回此刻有效的權杖。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 完成這項設定

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 監察

驗證日期