EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

10 minutes

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.

Manage Business Comment

A permissão do TikTok para responder, curtir, ocultar e excluir comentários; ler comentários é uma permissão separada.

1 hour

Por quanto tempo um link de conexão do easyCoexistence para a conta TikTok de um cliente funciona antes de a sessão expirar.

3 days

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.

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", … }

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

  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.

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.
Fazendo isso com o EasyCoexistence

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