Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

15 a day

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.

1 GB

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.

35 images

Máximo de imagens que uma publicação de fotos do TikTok pode ter; cada uma em JPG, JPEG ou WebP, até 20 MB.

90

Unidades de código UTF-16 que o título de uma publicação de fotos do TikTok pode ter.

90 days

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.

Schedule a TikTok video
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 postPhoto post
MediaOne video, MP4, MOV or WebM1 to 35 images, JPEG or WebP
SizeUp to 1 GB, 3 to 600 seconds, at least 360 pxUp to 20 MB per image
TitleNone; the caption onlytitle, up to 90 characters
Commentsdisable_comment turns them offdisable_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.
Fazer isto com a EasyCoexistence

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