Como adicionar publicações no TikTok ao seu SaaS
Um SaaS adiciona publicações no TikTok ligando a conta TikTok de cada cliente através de uma ligação alojada e, depois, chamando o POST /channels/{id}/posts da easyCoexistence com um vídeo ou entre 1 e 35 imagens e uma legenda, agora ou com um publish_at até 90 dias à frente. A publicação segue pela API for Business do TikTok, que permite 15 publicações por dia por conta, e o seu backend fica a saber quando estiver no ar.
Publicações de vídeo que o TikTok publica por conta através da sua API for Business, a não mais de seis por minuto.
Maior vídeo que o endpoint de publicação do TikTok aceita, em MP4, MOV ou WebM, com 3 a 600 segundos de duração.
Máximo de imagens que uma publicação de fotos do TikTok pode ter; cada uma em JPG, JPEG ou WebP, até 20 MB.
Unidades de código UTF-16 que o título de uma publicação de fotos do TikTok pode ter.
Até quando o endpoint de publicações da easyCoexistence pode agendar uma publicação no TikTok.
Como é que um cliente liga o TikTok?
Através de uma sessão de ligação com channel definido como tiktok. A página alojada mostra o seu nome e o botão Continuar com o TikTok, que abre o ecrã de consentimento do próprio TikTok no mesmo separador; o cliente inicia sessão, autoriza o acesso e regressa ao seu redirect_url com um channel_id. Guarde-o junto ao cliente, já que cada pedido de publicação indica o canal.
Como é um pedido de publicação no TikTok?
Um POST para /channels/{id}/posts com a legenda em text e o ficheiro em media. Omita publish_at para publicar agora, ou defina uma hora ISO 8601 com o respetivo offset para publicar mais tarde. Uma publicação imediata responde com 201, ou com 422 e o motivo do TikTok se falhar.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: tt_video_5530" \
-d '{
"text": "Behind the scenes of our new store #opening",
"media": [{ "url": "https://cdn.example.com/store-tour.mp4", "type": "video" }],
"disable_comment": false,
"publish_at": "2026-11-10T18:00:00-05:00"
}'Publicação de vídeo ou de fotos: o que exige cada uma?
Uma publicação no TikTok é um vídeo ou um conjunto de imagens, nunca os dois, e não leva ligações. O texto, até 2,200 caracteres aqui, é a legenda em ambas, e as regras de ficheiro do próprio TikTok são verificadas antes de a publicação ser colocada em fila:
| Video post | Photo post | |
|---|---|---|
| Media | One video, MP4, MOV or WebM | 1 to 35 images, JPEG or WebP |
| Size | Up to 1 GB, 3 to 600 seconds, at least 360 px | Up to 20 MB per image |
| Title | None; the caption only | title, up to 90 characters |
| Comments | disable_comment turns them off | disable_comment turns them off |
Onde tem de estar o conteúdo multimédia?
Em qualquer endereço HTTPS, ou no armazenamento da easyCoexistence. O TikTok só transfere a partir de prefixos de URL verificados para a aplicação, por isso a easyCoexistence serve cada ficheiro a partir do seu próprio prefixo verificado e não tem de verificar nada. O conteúdo de uma publicação agendada é copiado quando a agendou, até 30 MB para imagens e 1 GB para vídeos, para que uma ligação que morra antes da hora de publicação não a consiga estragar. Para carregar um ficheiro em vez disso, POST /media devolve um media_id.
Como se sabe que uma publicação está no ar?
Pelo estado da publicação e pelos eventos. Uma publicação passa de scheduled para publishing e depois para processing, enquanto o TikTok transfere e verifica o ficheiro; a easyCoexistence pede ao TikTok o estado de 20 em 20 segundos até este indicar que a publicação está concluída. O seu URL de eventos recebe então post.published com a publicação e o respetivo canal, ou post.failed com o motivo da rede. GET /posts/{id} mostra o mesmo, com network_post_id e permalink quando estiver no ar.
Como funcionam as alterações, os cancelamentos e as novas tentativas?
Na própria publicação, enquanto o TikTok ainda não a tiver. PATCH /posts/{id} altera publish_at, text ou title numa publicação agendada; para mudar o conteúdo, cancele-a com DELETE /posts/{id} e crie uma nova. POST /posts/{id}/retry volta a publicar uma publicação que falhou. Quando o TikTok não der confirmação no prazo de 2 horas, a publicação falha com may_be_published a true, e a nova tentativa exige confirm definido como true.
O que acontece aos comentários depois da publicação?
Podem chegar ao seu produto. PUT /channels/{id}/webhook encaminha os eventos comment.update do TikTok, assinados, para o seu endpoint, e o seu backend responde ao comentário através de business/comment/reply/create/ do TikTok, com o token devolvido pela chamada de credenciais. As respostas no TikTok são públicas, já que uma ligação ao TikTok não tem mensagens privadas.
Erros comuns
- Enviar imagens PNG para uma publicação de fotos. O TikTok só aceita JPEG ou WebP, pelo que a publicação é recusada antes de entrar em fila.
- Pôr um título numa publicação de vídeo. title é para publicações de fotos, e um vídeo leva as suas palavras apenas na legenda.
- Voltar a tentar uma publicação com may_be_published a true sem verificar. O TikTok pode já a ter publicado, por isso confirme a conta antes de repetir com confirm.
- Planear mais de 15 publicações por dia para uma conta. O TikTok limita as publicações por API por conta, por isso distribua o calendário de um cliente por vários dias.
A easyCoexistence adiciona publicações no TikTok ao seu SaaS: os seus clientes ligam as contas TikTok através de uma ligação alojada, e o seu backend publica vídeos e fotos agora ou mais tarde, fica a saber quando cada uma está no ar e recebe os respetivos comentários. A mesma API cobre WhatsApp, Instagram, Facebook, YouTube, LinkedIn e mais canais, com cada ligação monitorizada 24/7. 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
Posso publicar vídeos do TikTok como rascunhos no meu SaaS?
Não. O endpoint de publicações da easyCoexistence publica o vídeo na conta, de imediato ou em publish_at. Use o agendamento para manter uma publicação em espera até o cliente estar pronto.
O TikTok permite agendar publicações através da API?
Os endpoints de publicação do TikTok atuam quando são chamados. A easyCoexistence mantém a publicação na sua fila e chama o TikTok em publish_at, até 90 dias à frente.
O meu SaaS pode desativar os comentários numa publicação do TikTok?
Sim. Defina disable_comment como true na publicação. Quando as definições da própria conta já desativam os comentários, o TikTok aceita apenas true.
Quanto custa a easyCoexistence por conta TikTok?
Cada conta TikTok que os seus clientes ligam custa de US$ 9 a US$ 0.75 por mês, conforme a faixa do seu total de ligações, com os primeiros 3 dias gratuitos.
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