Como conectar uma conta do TikTok a uma API ou agente de IA
Uma conta do TikTok se conecta a uma API ou agente de IA pela tela de autorização do próprio TikTok: o dono faz login e aprova as permissões que o app solicita, como publicar posts, gerenciar comentários e ler insights. O TikTok devolve um código, válido por 10 minutos e de uso único, e o app o troca pelo token de acesso da conta, agindo dentro dessas permissões até que o dono remova o acesso.
O easyCoexistence conecta contas pessoais e Business do TikTok pelo próprio login do TikTok, pelo painel ou por um link de conexão que seus clientes abrem sozinhos, e então dá ao Claude, ao ChatGPT ou à sua própria plataforma as ferramentas, com tokens renovados e cada conta verificada o tempo todo.
Por quanto tempo o código de autorização que o TikTok devolve após a aprovação continua válido, para uma única troca.
A permissão do TikTok para responder, curtir, ocultar e excluir comentários; ler comentários é uma permissão separada.
Por quanto tempo um link de conexão do easyCoexistence para a conta TikTok de um cliente funciona antes de a sessão expirar.
Período de teste gratuito contado a partir da primeira conexão da conta; um cartão é salvo antes do primeiro login.
O que a tela de autorização do TikTok pede?
Que se aprove o acesso de um app à conta. O app envia o dono para a URL de autorização do titular da conta no TikTok, onde aparecem o logo do app e as permissões que ele solicita, como publicar posts, ler e gerenciar comentários e ler insights. Quando o dono aprova, o TikTok redireciona para o endereço registrado do app com um código de autorização que dura 10 minutos e funciona uma única vez, e o app o troca pelos tokens da conta. Se o dono já tiver aprovado as mesmas permissões antes, o TikTok pula a página de revisão e redireciona direto de volta.
Por que aprovar cada permissão?
Porque um token de acesso carrega apenas o que o dono aprovou, e cada endpoint da Accounts API precisa da sua própria permissão. A referência de permissões do TikTok coloca a publicação em Video Publish, a leitura de comentários em Get Business Comment, responder, ocultar e excluir em Manage Business Comment, e os posts e insights de perfil da conta em permissões próprias. Uma chamada cuja permissão está ausente falha com o erro 40001, e a solução é o dono autorizar o app de novo.
Como conectar uma conta do TikTok ao easyCoexistence?
Pelo painel, em um navegador, porque o login acontece na própria página do TikTok. Escolha 'New connection', depois TikTok, faça login na conta e aprove as permissões; você volta ao painel com a conta conectada. Um cartão é salvo antes da primeira conexão, nada é cobrado nos primeiros 3 dias, e contas pessoais e Business funcionam. Todo o login precisa terminar em até 10 minutos após o início; depois disso, comece de novo em 'New connection'.
O que acontece depois que a conta está conectada?
Sua IA pode usá-la. list_social_accounts retorna a conta com seu account_id, o ID que cada ferramenta do TikTok recebe, e o status dela. Os eventos de comentário da conta começam a chegar ao easyCoexistence, o token de acesso, com validade de um dia, é renovado antes de expirar, e a conta é verificada a cada 6 horas, com um e-mail para você caso o TikTok a recuse. O painel ganha uma página para a conta, com a saúde dela, o destino dos seus eventos de comentário e como usá-la pela sua IA.
Como uma plataforma conecta as contas do TikTok de seus clientes?
Com um link de conexão, que o cliente abre sem ter uma conta no easyCoexistence. Seu backend faz POST para /connect-sessions com channel definido como tiktok e seu redirect_url, depois envia o cliente para a url retornada. A página hospedada mostra um único botão, 'Continue with TikTok', que abre a tela do TikTok na mesma aba, então também funciona no celular. O cliente volta ao seu redirect_url com um channel_id, e a conta pertence à sua conta, e é cobrada dela.
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", … }E se o login não terminar?
A conta só fica conectada depois que a tela do TikTok é aprovada e o código trocado, então uma tentativa que falha simplesmente é iniciada de novo:
- O dono fecha ou recusa a tela do TikTok: o painel informa que nada foi conectado, e 'New connection' recomeça o processo.
- Passam-se mais de 10 minutos: o login expira, e um cliente com link de conexão volta à página hospedada para tentar de novo.
- A conta do TikTok já está conectada a outra conta do easyCoexistence: remova-a lá primeiro e depois conecte aqui.
- Um link de conexão passou de uma hora: crie uma nova sessão para o cliente.
Como configurar
- 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.
- Sign in on TikTokTikTok's page opens. Sign in with the TikTok account you want to connect.
- Approve the permissionsReview the permissions easyCoexistence asks for, approve each of them, and authorize.
- Back in the dashboardTikTok returns you to easyCoexistence, where the account shows as connected and your AI finds it with list_social_accounts.
Erros comuns
- Deixar uma permissão sem aprovar na tela do TikTok. O token então não tem esse escopo, e as chamadas correspondentes continuam falhando até o dono autorizar o app de novo.
- Enviar ao cliente o link do painel. Clientes se conectam por um link de conexão gerado pelo seu backend, que não exige conta no easyCoexistence e os devolve ao seu app.
- Esperar que a IA faça login pelo chat. A autorização do TikTok exige um navegador, então get_social_connect_link entrega o link do painel e os passos.
De US$ 9 até US$ 0.75 por conexão por mês, com redução conforme você adiciona conexões, e os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Preciso de uma conta TikTok Business para conectar?
Não. Contas pessoais e Business se conectam, e alguns campos de insights precisam de Advanced Access ou de uma Verified Business Account.
A Claude ou o ChatGPT podem conectar a conta por mim?
Podem entregar o link para você. get_social_connect_link retorna o endereço do painel e os passos, já que o login do TikTok precisa acontecer em um navegador.
O easyCoexistence vê minha senha do TikTok?
Não. Você faz login na página do próprio TikTok, e o TikTok entrega ao easyCoexistence um código de autorização, nunca a sua senha.
Um cliente pode conectar a conta pelo celular?
Sim. O botão do TikTok no link de conexão abre o login do TikTok na mesma aba, o que funciona no celular.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em