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

如何获取客户的 WhatsApp、Instagram 和 TikTok API 访问令牌

easyCoexistence 的 Partner API 只需一次 GET 请求并附带 ?credentials=1,即可返回已连接客户的访问令牌和 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

YouTube 频道 API 调用所用 Google 用户访问令牌的有效期。

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 的号码、已暂停或已移除的号码,以及 status 不是 connected 的频道,此时备注会要求发起新的连接会话。404 not_found 表示该 ID 不在您的账户下;502 credentials_unavailable 表示此刻无法获取新的社交访问令牌,请重试,若重复出现,请检查频道的 status。

常见错误

  • 将 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 监控

验证时间