Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Como ligar uma conta TikTok a uma API ou agente de IA

Uma conta TikTok liga-se a uma API ou agente de IA através do ecrã de autorização do TikTok: o titular inicia sessão e aprova as permissões que a aplicação pede, como publicar conteúdos, gerir comentários e ler estatísticas. O TikTok devolve um código, válido durante 10 minutos e utilizável uma única vez, que a aplicação troca pelo token de acesso da conta, atuando dentro dessas permissões até que o titular remova o seu acesso.

O easyCoexistence liga contas TikTok pessoais e Business através do próprio início de sessão do TikTok, a partir do painel ou de uma hiperligação de ligação que os seus clientes abrem por si próprios, e depois dá ao Claude, ao ChatGPT ou à sua própria plataforma as respetivas ferramentas, com os tokens renovados e cada conta verificada sem interrupção.

10 minutes

Durante 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, marcar gosto, ocultar e eliminar comentários; lê-los é uma permissão separada.

1 hour

Durante quanto tempo funciona uma hiperligação de ligação do easyCoexistence para a conta TikTok de um cliente, antes de a sessão expirar.

3 days

Período de teste gratuito contado desde a primeira ligação da conta; um cartão é guardado antes do primeiro início de sessão.

O que pede o ecrã de autorização do TikTok?

Aprovar o acesso de uma aplicação à conta. A aplicação envia o titular para o URL de autorização do TikTok, onde surge o logótipo da aplicação com as permissões que pede, como publicar conteúdos, ler e gerir comentários e ler estatísticas. Quando o titular aprova, o TikTok redireciona para o endereço registado da aplicação com um código de autorização, válido durante 10 minutos e utilizável uma única vez, que a aplicação troca pelos tokens da conta. Se o titular já tinha aprovado as mesmas permissões, o TikTok salta a página de revisão e redireciona diretamente de volta.

Porque aprovar cada permissão?

Porque um token de acesso transporta apenas o que o titular aprovou, e cada endpoint da API Accounts 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, e responder, ocultar e eliminar em Manage Business Comment, e as publicações e as estatísticas de perfil da conta em permissões próprias. Uma chamada sem a permissão necessária falha com o erro 40001, e a solução é o titular autorizar a aplicação de novo.

Como ligar uma conta TikTok ao easyCoexistence?

A partir do painel, num navegador, porque o início de sessão acontece na página do próprio TikTok. Escolha Nova ligação, depois TikTok, inicie sessão na conta e aprove as permissões; regresse ao painel com a conta ligada. Um cartão é guardado antes da primeira ligação, não se cobra nada nos primeiros 3 dias, e as contas pessoais e Business funcionam ambas. Todo o início de sessão tem de terminar até 10 minutos após o começar; passado esse tempo, recomece a partir de Nova ligação.

O que acontece depois de a conta estar ligada?

A sua IA pode utilizá-la. list_social_accounts devolve a conta com o seu account_id, o ID que cada ferramenta do TikTok recebe, e o respetivo estado. Os eventos de comentário da conta começam a chegar ao easyCoexistence, o token de acesso, que dura um dia, é renovado antes de expirar, e a conta é verificada de 6 em 6 horas, com um email para si se o TikTok a recusar. O painel passa a ter uma página para a conta, com o seu estado, para onde vão os seus eventos de comentário e como o utilizar a partir da sua IA.

Como liga uma plataforma as contas TikTok dos seus clientes?

Com uma hiperligação de ligação, que o cliente abre sem ter uma conta no easyCoexistence. O seu backend envia um pedido POST para /connect-sessions com channel definido como tiktok e o seu redirect_url, e depois envia o cliente para o URL que ele devolve. A página alojada mostra um único botão, Continuar com TikTok, que abre o ecrã do TikTok no mesmo separador, pelo que funciona também num telemóvel. O cliente regressa ao seu redirect_url com um channel_id, e a conta fica associada à sua conta e é faturada nela.

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 início de sessão não terminar?

A conta só fica ligada quando o ecrã do TikTok é aprovado e o código trocado, por isso uma tentativa falhada recomeça-se simplesmente:

  • O titular fecha ou recusa o ecrã do TikTok: o painel indica que nada foi ligado, e Nova ligação começa de novo.
  • Passam mais de 10 minutos: o início de sessão expira, e um cliente com uma hiperligação de ligação volta à página alojada para tentar de novo.
  • A conta do TikTok já está ligada a outra conta do easyCoexistence: remova-a aí primeiro e depois ligue-a aqui.
  • Uma hiperligação de ligação ultrapassou o prazo 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 por aprovar no ecrã do TikTok. O token fica então sem esse âmbito, e as chamadas correspondentes continuam a falhar até o titular autorizar a aplicação de novo.
  • Enviar ao cliente a hiperligação do painel. Os clientes ligam-se através de uma hiperligação de ligação gerada pelo seu backend, que não precisa de conta no easyCoexistence e os devolve à sua aplicação.
  • Esperar que a IA inicie sessão a partir do chat. A autorização do TikTok precisa de um navegador, por isso get_social_connect_link entrega-lhe a hiperligação do painel e os passos.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Preciso de uma conta TikTok Business para ligar?

Não. As contas pessoais e Business ligam-se ambas, e alguns campos de estatísticas exigem Advanced Access ou uma Verified Business Account.

Consegue o Claude ou o ChatGPT ligar a conta por mim?

Podem dar-lhe a ligação. get_social_connect_link devolve o endereço do painel e os passos, já que o início de sessão do TikTok tem de acontecer num navegador.

Vê o easyCoexistence a minha palavra-passe do TikTok?

Não. O início de sessão é feito na página do próprio TikTok, e o TikTok entrega ao easyCoexistence um código de autorização, nunca a sua palavra-passe.

Um cliente pode ligar a conta a partir do telemóvel?

Sim. O botão do TikTok na hiperligação de ligação abre o início de sessão do TikTok no mesmo separador, o que funciona num telemóvel.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em