Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Paano makuha ang API tokens ng mga customer para sa WhatsApp, Instagram at TikTok

Ibinabalik ng Partner API ng easyCoexistence ang API token at mga ID ng naka-connect na customer gamit ang isang GET at ?credentials=1. Para sa WhatsApp numero, ibinibigay ng /connections/{id} ang waba_id, phone_number_id, ang Graph API base, ang send endpoint, at ang sariling token ng negosyo ng customer. Para sa social account, ibinibigay ng /channels/{id} ang API base ng network, ang ID ng account doon, at access token na ni-renew para sa inyo, kaya kunin po ninyo ito sa simula ng bawat job.

?credentials=1

Nagdaragdag ng credentials sa GET /connections/{id} para sa WhatsApp numero at sa GET /channels/{id} para sa social account.

1 hour

Haba ng buhay ng Google user access token, ang uri na dala ng mga API call ng isang YouTube channel.

1 day

Bisa ng TikTok account access token mula sa API for Business; valid ang refresh token nito sa loob ng isang taon.

60 days

Gaano katagal mananatiling valid ang na-refresh na long-lived Instagram token, mula sa araw ng pag-refresh.

No expiry

Ang long-lived Page access token ng Meta ay walang expiration date, bagaman may ilang kondisyon na maaaring magpawalang-bisa dito.

Aling call ang nagbabalik ng credentials ng isang koneksyon?

Ang sariling GET ng resource na may ?credentials=1, na in-authenticate gamit ang inyong ec_live_ key bilang bearer token. Nasa /connections/{id} ang WhatsApp numero at nasa /channels/{id} ang social account, bawat isa ay may sariling ID namespace: ang connect redirect ay nagbibigay ng connection_id para sa numero at channel_id para sa social account. Inilalista ng GET /connections at GET /channels ang mga ito, at pinapaliit ng ?external_ref= ang alinmang listahan sa isang customer lamang. Kapag walang parameter, ang parehong call ay magbabalik ng koneksyon na walang token dito.

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"

Ano ang ibinabalik ng credentials call ng WhatsApp numero?

Ang mismong koneksyon at isang credentials object. Tinutukoy ng waba_id at phone_number_id ang WhatsApp Business Account at ang numero sa Graph API ng Meta, at sinasabi ng token_ready kung may customer token na nakatala. Sa loob ng credentials, dala na ng graph_api_base at send_endpoint ang bersyon ng Graph API, at ang access_token ang token ng negosyo na inisyu ng Meta noong kumonekta ang customer, na nakasaklaw sa customer na iyon. Direktang tatawagin ng backend ninyo ang Meta para magpadala, mamahala ng template, mag-upload ng media, at mag-edit ng profile ng negosyo.

  • status: connected, degraded, disconnected, banned, suspended, removed, o unknown.
  • quality_rating at messaging_tier: rating ng Meta, gaya ng GREEN, at tier ng numero, gaya ng TIER_1K.
  • webhook_url: kung saan ipinapadala ng Meta ang mga mensahe ng numero, o null.
  • disconnected_reason, last_checked_at, last_event_at at created_at: dahilan ng pagkakadiskonekta ng Meta kung may nakatala, at mga timestamp sa 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. …"
  }
}

Ano ang ibinabalik ng credentials call ng bawat social network?

Ang view ng channel, pareho sa GET /channels/{id}, na may id, channel, external_ref, name, username, external_id, status at token_ready, at may credentials object din. Bawat credentials ng network ay may platform, isang API base, ang ID ng account sa network na iyon, access_token, token_expires_at, token_note, at mga halimbawang call. Ang ID field, at anumang iba pang kailangan ng isang network, ay nag-iiba:

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.

Bakit kukunin ang social token sa bawat job sa halip na itago ito?

Dahil may ilan na nagre-rotate sa loob ng isang araw, at laging sumasagot ang credentials call ng token na valid sa sandaling iyon. Nag-e-expire ang Google token ng YouTube pagkaraan ng isang oras at ang TikTok nang isang araw, at nire-renew ng easyCoexistence ang pareho bago pa maubos. Ang sa Instagram ay tumatagal ng 60 araw at nire-refresh nang maaga bago pa iyon, na naglalabas ng bagong token. Hindi nag-e-expire ang token ng Facebook Page habang nananatiling konektado ang Page. Ang isang request sa simula ng bawat job ay pumipigil sa code ninyo na tumawag kailanman sa network gamit ang token na nag-expire na.

Dapat bang itabi ang token ng WhatsApp numero?

Oo. Ito ang token ng negosyo mula sa Embedded Signup ng Meta, na sinasaklaw ng Meta sa customer na iyon, at hinihingi ng reference na itabi ninyo ito sa sarili ninyong panig, dahil hindi ito ipinapakita ng dashboard. Basahin ulit ito pagkatapos ng bawat connection.connected event, dahil maaaring maglabas ng bago ang muling pagkonekta. Hindi na ibinabalik ang token ng suspended o removed na numero, at ang customer token na hindi na tinatanggap ng Meta habang sumasagot pa ang numero ay na-retire, kaya nagiging false ang token_ready.

Ano ang ibig sabihin ng token_ready at token_missing?

Nagiging true ang token_ready kapag may customer token na nakatala at aktibo ang koneksyon. Sa isang numero, maaari itong maging false kaagad pagkatapos kumonekta, dahil minsan natatapos ng Meta ang Embedded Signup nang hindi naglalabas ng customer token. Hihilingin ng hosted page sa customer na ulitin ang proseso, at matatanggap ng events endpoint ninyo ang connection.token_missing. Kung lalaktawan nila ito, makakatanggap ng mensahe ang numero dahil valid ang mga ID nito, pero hindi ito makakapagpadala. Ang bagong connect session para sa customer na iyon ay naglalabas ng token at hindi kailanman pumapalit sa token na gumagana na. Ang social channel ay walang token_missing: laging nagbibigay ng sariling token ng customer ang kanilang sign-in, kaya sinusundan ng token_ready ang status.

Ano ang lumalabas kapag walang token na maibibigay ang koneksyon?

Isang 200 na sagot kung saan null ang access_token ng credentials at may tala kung ano ang dapat gawin, sa halip na error. Kasama rito ang numerong may token_ready na false, ang suspended o removed na numero, at ang channel na hindi connected ang status, kung saan hinihingi ng tala ang bagong connect session. Ang 404 not_found ay nangangahulugang wala ang ID sa account ninyo, at ang 502 credentials_unavailable ay nangangahulugang hindi makuha ang bagong social token sa sandaling iyon; subukan ulit, at tingnan ang status ng channel kapag paulit-ulit.

Mga karaniwang pagkakamali

  • Pag-cache ng YouTube o TikTok token sa config file. Nag-e-expire ang mga ito sa loob ng isang oras at isang araw, kaya tawagin ang credentials endpoint sa simula ng bawat job at ipaubaya ang renewal sa easyCoexistence.
  • Pagpapadala mula sa numerong may token_ready na false. Walang customer token na magagamit sa pagtawag sa Meta; magbukas ng bagong connect session para sa customer na iyon para makapaglabas ito ng isa.
  • Pagtawag sa TikTok gamit ang Authorization header. Ang Business API nila ay tumatanggap ng token sa Access-Token header, kasama ang business_id ng account sa bawat request.
  • Pagtawag sa LinkedIn gamit lamang ang bearer token. Kailangan din ng LinkedIn ang mga header na LinkedIn-Version at X-Restli-Protocol-Version na nakalista sa required_headers, at naka-URL-encode ang mga URN sa mga path.
Ginagawa ito gamit ang EasyCoexistence

Ikinokonekta ng easyCoexistence ang mga WhatsApp numero ng inyong mga customer at ang kanilang Instagram, Facebook, TikTok, YouTube at LinkedIn account, at marami pang iba pang channel, at saka ibinibigay sa backend ninyo ang credentials ng bawat koneksyon kapag hiniling, na may social token na ni-renew at bawat koneksyon ay namo-monitor 24/7. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang nagdaragdag kayo ng koneksyon, na may unang 3 araw na free trial.

Mga madalas itanong

Sariling token ba ng customer ang WhatsApp token?

Oo. Ito ang token ng negosyo na inisyu ng Meta kapag kumonekta ang customer sa pamamagitan ng Embedded Signup, na nakasaklaw sa customer na iyon. Hindi kailanman inilalantad ang system token ng easyCoexistence, at nagbabalik lamang ang call ng token kapag true ang token_ready.

Gaano katagal ang mga social access token?

Ang sa YouTube ay tumatagal ng isang oras, ang sa TikTok ng isang araw, at ang sa Instagram hanggang 60 araw, habang hindi nag-e-expire ang token ng Facebook Page. Nire-renew ng easyCoexistence ang mga nagre-rotate, kaya ang bawat credentials call ay nagbabalik ng token na gumagana na ngayon.

Kailangan ko ba ng sarili kong developer app sa bawat network?

Hindi. Nagsasa-sign in ang mga customer gamit ang sariling app ng easyCoexistence sa Meta, TikTok, Google at LinkedIn, at ibinibigay ng credentials call sa backend ninyo ang token para direktang tawagin ang API ng network na iyon.

Mababasa rin ba ng assistant tulad ng Claude o ChatGPT ang parehong credentials?

Oo. Kapag naka-sign in sa account ninyo sa pamamagitan ng MCP server, maaari nitong tawagin ang get_api_credentials para sa numero at ang get_social_credentials para sa social account, na nagbabalik ng parehong credentials gaya ng Partner API.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong