AccediInizia la prova gratuita
easyCoexistence API ufficiali

Come collegare un account TikTok a un'API o a un agente AI

Un account TikTok si collega a un'API o a un agente AI attraverso la schermata di autorizzazione di TikTok: il proprietario accede e approva i permessi richiesti dall'app, come la pubblicazione dei post, la gestione dei commenti e la lettura delle statistiche. TikTok restituisce un codice, valido per 10 minuti e utilizzabile una sola volta, che l'app scambia con il token di accesso dell'account, operando entro quei permessi finché il proprietario non ne revoca l'accesso.

easyCoexistence collega gli account TikTok personali e Business tramite l'accesso di TikTok stesso, dalla dashboard o da un link di connessione che i tuoi clienti aprono da soli, poi dà a Claude, ChatGPT o alla tua piattaforma i loro strumenti, con i token rinnovati e ogni account controllato 24 ore su 24.

10 minutes

Per quanto tempo resta valido il codice di autorizzazione che TikTok restituisce dopo l'approvazione, per un solo scambio.

Manage Business Comment

Il permesso di TikTok per rispondere, mettere Mi piace, nascondere ed eliminare i commenti; leggerli è un permesso separato.

1 hour

Per quanto tempo resta attivo un link di connessione di easyCoexistence per l'account TikTok di un cliente, prima che la sessione scada.

3 days

Prova gratuita conteggiata dalla prima connessione dell'account; una carta viene salvata prima del primo accesso.

Cosa chiede la schermata di autorizzazione di TikTok?

Di approvare l'accesso di un'app all'account. L'app invia il proprietario all'URL di autorizzazione del titolare dell'account su TikTok, dove compare il logo dell'app con i permessi richiesti, come la pubblicazione dei post, la lettura e la gestione dei commenti e la lettura delle statistiche. Quando il proprietario approva, TikTok reindirizza all'indirizzo registrato dell'app con un codice di autorizzazione valido per 10 minuti e utilizzabile una sola volta, che l'app scambia con i token dell'account. Se il proprietario ha già approvato gli stessi permessi, TikTok salta la pagina di revisione e reindirizza subito indietro.

Perché approvare ogni permesso?

Perché un token di accesso contiene solo ciò che il proprietario ha approvato, e ogni endpoint dell'Accounts API richiede un proprio permesso. Il riferimento dei permessi di TikTok associa la pubblicazione a Video Publish, la lettura dei commenti a Get Business Comment, la risposta, il nascondimento e l'eliminazione a Manage Business Comment, e i post e le statistiche del profilo a permessi dedicati. Una chiamata senza il permesso necessario fallisce con l'errore 40001, e per risolvere il proprietario deve autorizzare di nuovo l'app.

Come si collega un account TikTok a easyCoexistence?

Dalla dashboard, in un browser, perché l'accesso avviene sulla pagina di TikTok. Scegli Nuova connessione, poi TikTok, accedi all'account e approva i permessi; tornerai alla dashboard con l'account collegato. Una carta viene salvata prima della prima connessione, nulla viene addebitato nei primi 3 giorni, e funzionano sia gli account personali sia quelli Business. L'intero accesso deve completarsi entro 10 minuti dall'avvio; passato questo tempo, ricomincia da Nuova connessione.

Cosa succede una volta collegato l'account?

La tua AI può usarlo. list_social_accounts restituisce l'account con il suo account_id, l'ID che ogni strumento TikTok richiede, e il suo stato. Gli eventi di commento dell'account iniziano ad arrivare a easyCoexistence, il token di accesso di durata giornaliera viene rinnovato prima della scadenza, e l'account viene verificato ogni 6 ore, con un'e-mail a te se TikTok lo rifiuta. La dashboard ha una pagina dedicata all'account, con il suo stato, dove finiscono i suoi eventi di commento e come usarlo dalla tua AI.

Come una piattaforma collega gli account TikTok dei propri clienti?

Con un link di connessione, che il cliente apre senza avere un account easyCoexistence. Il tuo backend invia una richiesta a /connect-sessions con channel impostato su tiktok e il tuo redirect_url, poi manda il cliente all'url restituito. La pagina ospitata mostra un solo pulsante, Continua con TikTok, che apre la schermata di TikTok nella stessa scheda, quindi funziona anche da telefono. Il cliente torna al tuo redirect_url con un channel_id, e l'account appartiene al tuo account e viene fatturato su di esso.

Create a connect link for a TikTok account
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "tiktok",
    "redirect_url": "https://app.example.com/tiktok/connected",
    "external_ref": "customer_1042"
  }'

# 201 Created
# { "id": "cs_…", "url": "https://easycoexistence.com/connect/cs_…", "channel": "tiktok", "status": "created", … }

Cosa succede se l'accesso non si completa?

L'account è collegato solo dopo che la schermata di TikTok è stata approvata e il codice scambiato, quindi un tentativo fallito si ripete semplicemente:

  • Il proprietario chiude o rifiuta la schermata di TikTok: la dashboard indica che non è stato collegato nulla, e Nuova connessione ricomincia da capo.
  • Passano più di 10 minuti: l'accesso scade, e un cliente con link di connessione torna alla pagina ospitata per riprovare.
  • L'account TikTok è già collegato a un altro account easyCoexistence: rimuovilo lì prima di collegarlo qui.
  • Un link di connessione è oltre la sua validità di un'ora: crea una nuova sessione per il cliente.

Come configurarlo

  1. Open New connectionSign in to easyCoexistence, open the dashboard and choose New connection, then TikTok. An account with no card saved is asked for one first.
  2. Sign in on TikTokTikTok's page opens. Sign in with the TikTok account you want to connect.
  3. Approve the permissionsReview the permissions easyCoexistence asks for, approve each of them, and authorize.
  4. Back in the dashboardTikTok returns you to easyCoexistence, where the account shows as connected and your AI finds it with list_social_accounts.

Errori comuni

  • Lasciare un permesso non approvato nella schermata di TikTok. Il token non avrà quell'ambito, e le chiamate corrispondenti continueranno a fallire finché il proprietario non autorizzerà di nuovo l'app.
  • Inviare al cliente il link della dashboard. I clienti si collegano tramite un link di connessione generato dal tuo backend, che non richiede un account easyCoexistence e li riporta alla tua app.
  • Aspettarsi che l'AI acceda dalla chat. L'autorizzazione di TikTok richiede un browser, quindi get_social_connect_link ti fornisce il link della dashboard e i passaggi.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0.75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni gratuiti.

Domande frequenti

Mi serve un account TikTok Business per collegarmi?

No. Si collegano sia gli account personali sia quelli Business, e alcuni campi di statistiche richiedono l'Advanced Access o un Verified Business Account.

Claude o ChatGPT possono collegare l'account al posto mio?

Possono consegnarti il link. get_social_connect_link restituisce l'indirizzo della dashboard e i passaggi, perché l'accesso a TikTok deve avvenire in un browser.

easyCoexistence vede la mia password di TikTok?

No. Accedi sulla pagina di TikTok stessa, e TikTok dà a easyCoexistence un codice di autorizzazione, mai la tua password.

Un cliente può collegare il suo account dal telefono?

Sì. Il pulsante TikTok del link di connessione apre l'accesso a TikTok nella stessa scheda, che funziona anche da telefono.

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