Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Cum obțineți token-urile API ale clienților pentru WhatsApp, Instagram și TikTok

Partner API al easyCoexistence returnează token-ul API al clientului conectat și ID-urile acestuia printr-un singur GET cu ?credentials=1. Pentru un număr WhatsApp, /connections/{id} oferă waba_id, phone_number_id, baza Graph API, endpoint-ul de trimitere și token-ul de firmă al clientului. Pentru un cont social, /channels/{id} oferă baza API a rețelei, ID-ul contului acolo și un token de acces reînnoit pentru dumneavoastră, așa că preluați-l la începutul fiecărei sarcini.

?credentials=1

Adaugă credențiale la GET /connections/{id} pentru un număr WhatsApp și la GET /channels/{id} pentru un cont social.

1 hour

Durata de valabilitate a unui token de acces Google pentru utilizator, tipul pe care îl folosesc apelurile API ale unui canal YouTube.

1 day

Valabilitatea unui token de acces pentru un cont TikTok, din API for Business; token-ul său de reîmprospătare este valabil un an.

60 days

Cât timp rămâne valabil un token Instagram de lungă durată reînnoit, numărat din ziua reînnoirii.

No expiry

Token-urile de acces pentru Pagină de lungă durată ale Meta nu au dată de expirare, deși anumite condiții le pot invalida.

Ce apel returnează credențialele unei conexiuni?

Apelul GET propriu al resursei, cu ?credentials=1, autentificat cu cheia dumneavoastră ec_live_ ca token Bearer. Un număr WhatsApp se află la /connections/{id}, iar un cont social la /channels/{id}, fiecare cu propriul spațiu de ID-uri: redirecționarea de conectare vă oferă connection_id pentru un număr și channel_id pentru un cont social. GET /connections și GET /channels le listează, iar ?external_ref= restrânge oricare listă la un singur client. Fără acest parametru, aceleași apeluri returnează conexiunea fără token.

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"

Ce returnează apelul de credențiale pentru un număr WhatsApp?

Conexiunea în sine, împreună cu un obiect credentials. waba_id și phone_number_id identifică contul WhatsApp Business și numărul în Graph API al Meta, iar token_ready arată dacă există un token al clientului salvat. În interiorul credentials, graph_api_base și send_endpoint includ deja versiunea Graph API, iar access_token este token-ul de firmă emis de Meta la conectarea clientului, limitat la acel client. Backend-ul dumneavoastră apelează apoi direct Meta pentru a trimite, gestiona șabloanele, încărca media și edita profilul firmei.

  • status: connected, degraded, disconnected, banned, suspended, removed sau unknown.
  • quality_rating și messaging_tier: evaluarea calității Meta, de exemplu GREEN, și nivelul de mesagerie al numărului, de exemplu TIER_1K.
  • webhook_url: unde trimite Meta mesajele numărului, sau null.
  • disconnected_reason, last_checked_at, last_event_at și created_at: motivul deconectării comunicat de Meta, atunci când există unul înregistrat, și marcaje temporale 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. …"
  }
}

Ce returnează apelul de credențiale al fiecărei rețele sociale?

Vederea canalului, identică cu GET /channels/{id}, cu câmpurile id, channel, external_ref, name, username, external_id, status și token_ready, împreună cu un obiect credentials. Fiecare rețea are în credentials câmpurile platform, o bază API, ID-ul contului pe acea rețea, access_token, token_expires_at, token_note și exemple de apeluri. Câmpul ID, ca și orice altceva de care are nevoie o rețea, diferă:

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.

De ce să preluați token-ul social la fiecare sarcină, în loc să îl stocați?

Pentru că unele se rotesc în decurs de o zi, iar apelul de credențiale răspunde întotdeauna cu un token valabil în acel moment. Token-ul Google pentru YouTube durează o oră, iar cel pentru TikTok o zi, iar easyCoexistence le reînnoiește pe amândouă înainte de expirare. Cel pentru Instagram durează 60 de zile și este reînnoit cu mult înainte, ceea ce emite un token nou. Un token de Pagină Facebook nu expiră cât timp Pagina rămâne conectată. O singură cerere la începutul fiecărei sarcini împiedică codul dumneavoastră să apeleze vreodată o rețea cu un token expirat.

Ar trebui să stocați token-ul unui număr WhatsApp?

Da. Este token-ul de firmă obținut prin Embedded Signup de la Meta, pe care Meta îl limitează la acel client integrat, iar referința vă cere să îl stocați pe partea dumneavoastră, deoarece panoul de control nu îl afișează. Citiți-l din nou după fiecare eveniment connection.connected, pentru că o reconectare poate emite unul nou. Token-ul unui număr suspendat sau eliminat nu mai este servit, iar un token al clientului pe care Meta încetează să îl accepte, în timp ce numărul încă răspunde, este retras, ceea ce face ca token_ready să fie false.

Ce înseamnă token_ready și token_missing?

token_ready este true când există un token al clientului salvat și conexiunea este activă. Pentru un număr, poate fi false chiar după conectare, deoarece Meta termină uneori Embedded Signup fără să emită token-ul clientului. Pagina găzduită îi cere apoi clientului să mai parcurgă o dată procesul, iar endpoint-ul dumneavoastră de evenimente primește connection.token_missing. Dacă ocolește pasul, numărul primește mesaje, deoarece ID-urile sale sunt valabile, dar nu poate trimite. O nouă sesiune de conectare pentru acel client emite token-ul și nu îl înlocuiește niciodată pe cel care deja funcționează. Canalele sociale nu au token_missing: conectarea lor emite întotdeauna token-ul propriu al clientului, astfel încât token_ready urmează statusul.

Ce se întoarce când o conexiune nu are token de oferit?

Un răspuns 200 al cărui obiect credentials are access_token null și o notă care indică ce trebuie făcut, în loc de o eroare. Acesta acoperă un număr cu token_ready false, un număr suspendat sau eliminat și un canal al cărui status nu este connected, unde nota cere o nouă sesiune de conectare. Un 404 not_found înseamnă că ID-ul nu se află în contul dumneavoastră, iar un 502 credentials_unavailable înseamnă că nu s-a putut obține în acel moment un token social proaspăt; reîncercați și verificați statusul canalului dacă se repetă.

Greșeli frecvente

  • Salvarea unui token YouTube sau TikTok într-un fișier de configurare. Acestea expiră într-o oră, respectiv o zi, așa că apelați endpoint-ul de credențiale la începutul fiecărei sarcini și lăsați reînnoirea în seama easyCoexistence.
  • Trimiterea de la un număr cu token_ready false. Nu există un token al clientului cu care să apelați Meta; deschideți o nouă sesiune de conectare pentru acel client, care emite unul.
  • Apelarea TikTok cu un antet Authorization. Business API primește token-ul într-un antet Access-Token, cu business_id al contului în fiecare cerere.
  • Apelarea LinkedIn doar cu bearer token. LinkedIn cere și antetele LinkedIn-Version și X-Restli-Protocol-Version, listate în required_headers, iar URN-urile din căi trebuie codificate URL.
Faceți acest lucru cu EasyCoexistence

easyCoexistence conectează numerele WhatsApp ale clienților dumneavoastră și conturile lor de Instagram, Facebook, TikTok, YouTube și LinkedIn, precum și alte canale, apoi transmite backend-ului dumneavoastră credențialele fiecărei conexiuni la cerere, cu token-urile sociale reînnoite și cu monitorizare 24/7 pentru fiecare conexiune. De la US$ 9 la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu perioadă de probă gratuită de 3 zile.

Întrebări frecvente

Token-ul WhatsApp este al clientului?

Da. Este token-ul de firmă pe care Meta îl emite când clientul se conectează prin Embedded Signup, limitat la acel client. Token-ul de sistem al easyCoexistence nu este niciodată expus, iar apelul returnează un token doar când token_ready este true.

Cât durează token-urile sociale de acces?

Token-ul YouTube durează o oră, cel TikTok o zi, iar cel Instagram până la 60 de zile, în timp ce un token de Pagină Facebook nu expiră. easyCoexistence reînnoiește token-urile care se rotesc, astfel încât fiecare apel de credențiale returnează un token care funcționează chiar acum.

Am nevoie de propria mea aplicație de dezvoltator pe fiecare rețea?

Nu. Clienții se conectează prin aplicația easyCoexistence de pe Meta, TikTok, Google și LinkedIn, iar apelul de credențiale transmite backend-ului dumneavoastră token-ul pentru a apela direct API-ul acelei rețele.

Un asistent precum Claude sau ChatGPT poate citi aceleași credențiale?

Da. Conectat la contul dumneavoastră prin serverul MCP, poate apela get_api_credentials pentru un număr și get_social_credentials pentru un cont social, care returnează aceleași credențiale ca Partner API.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la