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