Como funciona o fluxo de publicação
Esta página descreve, em linguagem direta, o caminho que um vídeo percorre dentro do Publisher até aparecer publicado na conta conectada. Ela existe para que qualquer pessoa que use a ferramenta saiba exatamente o que acontece com o conteúdo e com os dados de acesso.
1. Conexão da conta
A conexão é feita pelo fluxo de autorização oficial do TikTok for Developers. Você é levado para a tela do próprio TikTok, entra na sua conta e vê quais permissões o aplicativo está pedindo. O Publisher nunca recebe a sua senha.
Depois da autorização, o TikTok devolve um código para o endereço de retorno registrado no aplicativo. Esse código é trocado, no servidor, por um token de acesso e um token de renovação. Os dois ficam armazenados de forma criptografada e são usados apenas para chamar a API de publicação em seu nome.
O token de acesso tem validade curta e é renovado automaticamente antes de expirar. A renovação também troca o token de renovação, e o valor novo substitui o anterior. Se você remover o acesso na plataforma, a renovação deixa de funcionar e a conexão precisa ser refeita por você.
2. Permissão usada
Para publicar vídeos, o Publisher usa a permissão de publicação de conteúdo do TikTok. Ela permite enviar um vídeo e os metadados do post para a conta que autorizou o aplicativo. Nada além disso é solicitado.
| O que é acessado | Para quê |
|---|---|
| Identificação básica da conta conectada | Mostrar qual conta está vinculada e evitar envio para a conta errada |
| Permissão de publicação de vídeo | Enviar o conteúdo revisado e confirmado |
| Informações do criador retornadas pela plataforma | Saber quais níveis de privacidade a conta aceita e qual é o limite de duração do vídeo |
| Status do envio | Confirmar se o vídeo foi processado e publicado |
O Publisher não acessa mensagens, lista de seguidores, métricas privadas, rascunhos ou qualquer recurso fora do necessário para publicar.
3. Preparo do vídeo
O material de origem passa por três checagens antes de entrar na fila:
- Formato: o vídeo é convertido para o enquadramento vertical usado pela plataforma.
- Marca d'água: sobreposições, logotipos e textos promocionais adicionados pela ferramenta são removidos do arquivo que vai para o envio.
- Duração: o limite é o informado pela própria plataforma para aquela conta no momento do envio, e não um número fixo.
4. Revisão
Antes de qualquer envio, a tela de revisão mostra a legenda, o nível de privacidade disponível, a capa escolhida e as opções de dueto, comentário e stitch. Você altera o que quiser e confirma aquele item.
A confirmação vale para uma publicação. Uma nova confirmação é necessária para o próximo vídeo. Não existe configuração de envio contínuo sem revisão item por item.
5. Envio e status
Com o item confirmado, o Publisher executa a sequência definida pela documentação da plataforma:
- consulta as informações do criador, para respeitar os limites daquela conta;
- inicializa o envio do vídeo com os metadados revisados;
- transfere o arquivo para o endereço de upload devolvido pela plataforma, ou informa uma URL pública de origem, quando esse é o método usado;
- consulta o status até receber a confirmação de processamento concluído.
O item só aparece no histórico como publicado depois da confirmação. Até lá, ele permanece marcado como em processamento.
6. Quando algo falha
Se a plataforma recusar o envio, o motivo é exibido em linguagem clara e o item volta para revisão em vez de ser dado como publicado. Os casos mais comuns são: token expirado, permissão insuficiente, limite de publicações atingido e nível de privacidade não aceito pela conta naquele momento. Nenhuma dessas situações é tratada como sucesso.
7. Limites da plataforma
Alguns comportamentos são definidos pelo TikTok e não pelo Publisher:
- a visibilidade do conteúdo publicado por aplicativos ainda em avaliação pode ficar restrita;
- há limite de publicações por conta e por período;
- a validação de vídeos, o processamento e a distribuição seguem critérios da plataforma;
- quando a origem do arquivo é uma URL pública, ela precisa estar em um domínio previamente verificado no aplicativo.
O Publisher informa o retorno da plataforma e não interfere nesses critérios.
8. Revogar acesso e excluir dados
Para desconectar, abra o TikTok e vá em Configurações e privacidade → Segurança e permissões → Gerenciar permissões de apps, localize o aplicativo e remova o acesso. A partir daí o Publisher não consegue mais publicar em seu nome.
Para excluir os dados armazenados, envie um pedido para [email protected]. O prazo e os detalhes estão na Política de Privacidade.