Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Kako dohvatiti API tokene kupaca za WhatsApp, Instagram i TikTok

easyCoexistence Partner API vraća API token i ID-jeve povezanog kupca jednim GET zahtjevom s ?credentials=1. Za WhatsApp broj, /connections/{id} daje waba_id, phone_number_id, Graph API baznu adresu, endpoint za slanje i vlastiti poslovni token kupca. Za društveni račun, /channels/{id} daje baznu adresu API-ja mreže, ID računa na toj mreži i pristupni token koji se za vas obnavlja, pa ga dohvatite na početku svakog zadatka.

?credentials=1

Dodaje objekt credentials u GET /connections/{id} za WhatsApp broj i u GET /channels/{id} za društveni račun.

1 hour

Trajanje Google tokena za pristup korisnika, one vrste koju nose API pozivi YouTube kanala.

1 day

Valjanost pristupnog tokena TikTok računa iz API-ja for Business; njegov token za osvježavanje vrijedi godinu dana.

60 days

Koliko dugo osvježeni dugotrajni Instagram token ostaje valjan, računajući od dana osvježavanja.

No expiry

Dugotrajni pristupni tokeni Facebook stranica nemaju datum isteka, ali ih određeni uvjeti mogu poništiti.

Koji poziv vraća vjerodajnice veze?

GET istog resursa s ?credentials=1, autentificiran vašim ključem ec_live_ kao bearer tokenom. WhatsApp broj nalazi se na /connections/{id}, a društveni račun na /channels/{id}, svaki sa svojim prostorom ID-jeva: povratna adresa nakon povezivanja daje connection_id za broj i channel_id za društveni račun. GET /connections i GET /channels navode ih, a ?external_ref= sužava bilo koji popis na jednog kupca. Bez parametra isti pozivi vraćaju vezu bez tokena.

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"

Što vraća poziv za vjerodajnice WhatsApp broja?

Samu vezu i objekt credentials. waba_id i phone_number_id identificiraju WhatsApp Business Account i broj na Metinom Graph API-ju, a token_ready pokazuje postoji li pohranjen token kupca. Unutar credentials, graph_api_base i send_endpoint već sadrže verziju Graph API-ja, a access_token je poslovni token koji je Meta izdala kad se kupac povezao, ograničen na tog kupca. Vaš backend zatim izravno poziva Metu za slanje, upravljanje predlošcima, prijenos medija i uređivanje poslovnog profila.

  • status: connected, degraded, disconnected, banned, suspended, removed ili unknown.
  • quality_rating i messaging_tier: Metina ocjena, npr. GREEN, i razina broja, npr. TIER_1K.
  • webhook_url: adresa na koju Meta šalje poruke broja, ili null.
  • disconnected_reason, last_checked_at, last_event_at i created_at: Metin razlog prekida veze kad je zabilježen te vremenske oznake u ISO 8601 formatu.
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. …"
  }
}

Što vraća pozivni zahtjev za vjerodajnice svake društvene mreže?

Pogled kanala, isti kao GET /channels/{id}, s id, channel, external_ref, name, username, external_id, status i token_ready, te objekt credentials. Vjerodajnice svake mreže sadrže platform, bazu API-ja, ID računa na toj mreži, access_token, token_expires_at, token_note i primjere poziva. Polje ID i sve ostalo što mreža zahtijeva razlikuje se:

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.

Zašto dohvaćati token društvene mreže pri svakom zadatku umjesto da ga spremate?

Zato što se neki rotiraju unutar jednog dana, a poziv za vjerodajnice uvijek odgovara tokenom koji je valjan u tom trenutku. Google token za YouTube traje sat, a TikTok token dan, a easyCoexistence obnavlja oba prije isteka. Instagramov traje 60 dana i osvježava se znatno ranije, pri čemu se izdaje novi token. Token Facebook stranice ne istječe dok je stranica povezana. Jedan zahtjev na početku svakog zadatka sprječava da vaš kod ikad pozove mrežu s isteklim tokenom.

Trebate li spremati token WhatsApp broja?

Da. To je poslovni token iz Metinog Embedded Signupa, koji Meta ograničava na tog uključenog kupca, a dokumentacija traži da ga pohranite na svojoj strani jer ga nadzorna ploča ne prikazuje. Ponovno ga pročitajte nakon svakog događaja connection.connected, jer ponovno povezivanje može izdati novi. Token suspendiranog ili uklonjenog broja više se ne isporučuje, a token kupca koji Meta prestane prihvaćati dok broj još odgovara povlači se, što token_ready postavlja na false.

Što znače token_ready i token_missing?

token_ready je true kad je token kupca pohranjen i veza je aktivna. Kod broja može biti false odmah nakon povezivanja, jer Meta ponekad završi Embedded Signup bez izdavanja tokena kupca. Hostirana stranica tada traži od kupca još jedan prolaz, a vaš endpoint za događaje primi connection.token_missing. Ako ga preskoče, broj prima poruke, jer su njegovi ID-jevi valjani, ali ne može slati. Nova sesija povezivanja za tog kupca izdaje token i nikad ne zamjenjuje onaj koji već radi. Društveni kanali nemaju token_missing: prijava uvijek daje vlastiti token kupca, pa token_ready slijedi status.

Što se vraća kad veza nema token?

Odgovor 200 u kojem credentials ima access_token null i napomenu što učiniti, a ne pogrešku. To vrijedi za broj s token_ready false, suspendirani ili uklonjeni broj i kanal čiji status nije connected; napomena tada traži novu sesiju povezivanja. 404 not_found znači da ID nije na vašem računu, a 502 credentials_unavailable znači da svježi društveni token nije mogao biti dobiven u tom trenutku. Pokušajte ponovno, a ako se ponovi, provjerite status kanala.

Uobičajene pogreške

  • Spremanje tokena YouTubea ili TikToka u konfiguracijsku datoteku. Istječu za sat odnosno dan, pa pozovite endpoint za vjerodajnice na početku svakog zadatka i prepustite obnavljanje sustavu easyCoexistence.
  • Slanje s broja čiji je token_ready false. Nema tokena kupca kojim bi se Meta mogla pozvati; otvorite novu sesiju povezivanja za tog kupca, koja ga izdaje.
  • Poziv TikToka s Authorization zaglavljem. Njegov Business API prima token u zaglavlju Access-Token, uz business_id računa u svakom zahtjevu.
  • Poziv LinkedIna samo s bearer tokenom. LinkedIn još traži zaglavlja LinkedIn-Version i X-Restli-Protocol-Version navedena u required_headers, a URN-ovi u putanjama moraju biti URL-kodirani.
Radite ovo uz EasyCoexistence

easyCoexistence povezuje WhatsApp brojeve vaših kupaca i njihove račune na mrežama Instagram, Facebook, TikTok, YouTube i LinkedIn, uz druge kanale. Na zahtjev predaje vašem backendu vjerodajnice svake veze, s obnovljenim društvenim tokenima i praćenjem svake veze 24/7. Od US$ 9 do US$ 0,75 po vezi mjesečno, a cijena pada kako dodajete veze, uz prva 3 dana besplatno.

Često postavljana pitanja

Je li WhatsApp token vlastiti token kupca?

Da. To je poslovni token koji Meta izdaje kad se kupac poveže putem Embedded Signupa, ograničen na tog kupca. Sustavni token easyCoexistence nikad se ne izlaže, a poziv vraća token samo kad je token_ready true.

Koliko traju društveni pristupni tokeni?

YouTubeov traje sat, TikTokov dan, a Instagramov do 60 dana, dok token Facebook stranice ne istječe. easyCoexistence obnavlja one koji se rotiraju, pa svaki poziv za vjerodajnice vraća token koji radi upravo sada.

Trebam li vlastitu razvojnu aplikaciju na svakoj mreži?

Ne. Kupci se prijavljuju kroz vlastitu aplikaciju easyCoexistence na mrežama Meta, TikTok, Google i LinkedIn, a poziv za vjerodajnice vašem backendu predaje token za izravno pozivanje API-ja te mreže.

Može li asistent, poput Claude ili ChatGPT, čitati iste vjerodajnice?

Da. Prijavljen na vaš račun putem MCP poslužitelja može pozvati get_api_credentials za broj i get_social_credentials za društveni račun, što vraća iste vjerodajnice kao Partner API.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na