AccediInizia la prova gratuita
easyCoexistence API ufficiali

Come ottenere i token API dei clienti per WhatsApp, Instagram e TikTok

La Partner API di easyCoexistence restituisce con una sola GET e ?credentials=1 il token API e gli ID di un cliente connesso. Per un numero WhatsApp, /connections/{id} fornisce waba_id, phone_number_id, la base della Graph API, l'endpoint di invio e il token dell'azienda del cliente. Per un account social, /channels/{id} fornisce la base API del social, l'ID dell'account su quel social e un token di accesso rinnovato per te, quindi richiedilo all'inizio di ogni esecuzione.

?credentials=1

Aggiunge credentials a GET /connections/{id} per un numero WhatsApp e a GET /channels/{id} per un account social.

1 hour

Durata di un token di accesso utente Google, quello che accompagna le chiamate API di un canale YouTube.

1 day

Validità di un token di accesso account TikTok dall'API for Business; il suo refresh token è valido per un anno.

60 days

Per quanto tempo resta valido un token Instagram long-lived rinnovato, conteggiato dal giorno del rinnovo.

No expiry

I token di accesso Page long-lived di Meta non hanno data di scadenza, anche se alcune condizioni possono invalidarli.

Quale chiamata restituisce le credenziali di una connessione?

La GET della risorsa stessa con ?credentials=1, autenticata con la tua chiave ec_live_ come bearer token. Un numero WhatsApp si trova in /connections/{id} e un account social in /channels/{id}, ciascuno con il proprio spazio di ID: il reindirizzamento di connessione ti restituisce connection_id per un numero e channel_id per un account social. GET /connections e GET /channels li elencano, e ?external_ref= restringe entrambe le liste a un solo cliente. Senza il parametro, le stesse chiamate restituiscono la connessione senza 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"

Cosa restituisce la chiamata delle credenziali di un numero WhatsApp?

La connessione stessa più un oggetto credentials. waba_id e phone_number_id identificano il WhatsApp Business Account e il numero nella Graph API di Meta, e token_ready indica se è presente un token del cliente. Dentro credentials, graph_api_base e send_endpoint includono già la versione della Graph API, e access_token è il token dell'azienda emesso da Meta quando il cliente si è connesso, limitato a quel cliente. Il tuo backend poi chiama direttamente Meta per inviare messaggi, gestire i template, caricare i media e modificare il profilo aziendale.

  • status: connected, degraded, disconnected, banned, suspended, removed o unknown.
  • quality_rating e messaging_tier: la valutazione di qualità di Meta, come GREEN, e il livello del numero, come TIER_1K.
  • webhook_url: dove Meta invia i messaggi del numero, oppure null.
  • disconnected_reason, last_checked_at, last_event_at e created_at: il motivo di disconnessione di Meta quando ne è registrato uno, e timestamp 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. …"
  }
}

Cosa restituisce la chiamata delle credenziali di ciascun social?

La vista del canale, uguale a GET /channels/{id}, con id, channel, external_ref, name, username, external_id, status e token_ready, più un oggetto credentials. Le credenziali di ogni social contengono platform, una base API, l'ID dell'account su quel social, access_token, token_expires_at, un token_note ed esempi di chiamate. Il campo ID, e tutto ciò che un social richiede, cambiano:

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.

Perché richiedere un token social a ogni esecuzione invece di salvarlo?

Perché alcuni ruotano entro un giorno, e la chiamata delle credenziali risponde sempre con un token valido in quel momento. Il token Google di YouTube dura un'ora e quello di TikTok un giorno, e easyCoexistence li rinnova entrambi prima che scadano. Quello di Instagram dura 60 giorni e viene rinnovato ben prima, emettendo un nuovo token. Il token di una Pagina Facebook non scade finché la Pagina resta connessa. Una richiesta all'inizio di ogni esecuzione evita che il tuo codice chiami un social con un token scaduto.

Dovresti salvare il token di un numero WhatsApp?

Sì. È il token dell'azienda emesso dall'Embedded Signup di Meta, che Meta limita a quel cliente onboardato, e la documentazione ti chiede di salvarlo dal tuo lato, perché la dashboard non lo mostra. Rileggilo dopo ogni evento connection.connected, perché una riconnessione può emetterne uno nuovo. Il token di un numero sospeso o rimosso non viene più restituito, e un token del cliente che Meta smette di accettare mentre il numero risponde ancora viene ritirato, e token_ready torna false.

Cosa significano token_ready e token_missing?

token_ready è true quando è presente un token del cliente e la connessione è attiva. Su un numero può essere false subito dopo la connessione, perché Meta a volte completa l'Embedded Signup senza emettere il token del cliente. La pagina ospitata chiede al cliente di ripetere la procedura, e l'endpoint degli eventi riceve connection.token_missing. Se il cliente salta questo passaggio, il numero riceve messaggi, perché i suoi ID sono validi, ma non può inviarne. Una nuova sessione di connessione per quel cliente emette il token e non sostituisce mai uno già funzionante. I canali social non hanno token_missing: il loro accesso restituisce sempre il token proprio del cliente, quindi token_ready segue status.

Cosa succede quando una connessione non ha un token da restituire?

Una risposta 200 in cui credentials contiene access_token null e una nota che spiega cosa fare, invece di un errore. Ciò vale per un numero con token_ready false, per un numero sospeso o rimosso e per un canale il cui status non è connected, dove la nota chiede una nuova sessione di connessione. Un 404 not_found significa che l'ID non è nel tuo account, e un 502 credentials_unavailable significa che in quel momento non è stato possibile ottenere un token social aggiornato; riprova, e controlla lo status del canale se si ripete.

Errori comuni

  • Memorizzare in un file di configurazione il token di YouTube o TikTok. Scadono entro un'ora e un giorno, quindi chiama l'endpoint delle credenziali all'inizio di ogni esecuzione e lascia il rinnovo a easyCoexistence.
  • Inviare da un numero con token_ready false. Non esiste un token del cliente con cui chiamare Meta; apri una nuova sessione di connessione per quel cliente, che ne emette uno.
  • Chiamare TikTok con un header Authorization. La sua Business API accetta il token in un header Access-Token, con il business_id dell'account in ogni richiesta.
  • Chiamare LinkedIn solo con il bearer token. LinkedIn richiede anche gli header LinkedIn-Version e X-Restli-Protocol-Version elencati in required_headers, e gli URN nei percorsi codificati in URL.
Farlo con EasyCoexistence

easyCoexistence collega i numeri WhatsApp dei tuoi clienti e i loro account Instagram, Facebook, TikTok, YouTube e LinkedIn, oltre ad altri canali, e poi consegna al tuo backend le credenziali di ogni connessione su richiesta, con i token social rinnovati e ogni connessione monitorata 24/7. Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni gratis.

Domande frequenti

Il token WhatsApp è quello del cliente?

Sì. È il token dell'azienda emesso da Meta quando il cliente si connette tramite Embedded Signup, limitato a quel cliente. Il token di sistema di easyCoexistence non viene mai esposto, e la chiamata restituisce un token solo quando token_ready è true.

Quanto durano i token di accesso dei social?

Quello di YouTube dura un'ora, quello di TikTok un giorno e quello di Instagram fino a 60 giorni, mentre un token di Pagina Facebook non scade. easyCoexistence rinnova quelli che ruotano, quindi ogni chiamata delle credenziali restituisce un token funzionante in quel momento.

Serve una mia app sviluppatore su ogni social?

No. I clienti accedono tramite l'app di easyCoexistence su Meta, TikTok, Google e LinkedIn, e la chiamata delle credenziali consegna al tuo backend il token per chiamare direttamente l'API di quel social.

Un assistente come Claude o ChatGPT può leggere le stesse credenziali?

Sì. Collegato al tuo account tramite il server MCP, può chiamare get_api_credentials per un numero e get_social_credentials per un account social, che restituisce le stesse credenziali della Partner API.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il