EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Como adicionar postagens no TikTok ao seu SaaS

Um SaaS adiciona postagens no TikTok conectando a conta TikTok de cada cliente por um link hospedado e chamando POST /channels/{id}/posts da easyCoexistence com um vídeo ou de 1 a 35 imagens e uma legenda, agora ou em um horário publish_at de até 90 dias à frente. A publicação sai pela API for Business do TikTok, que permite 15 posts por dia por conta, e o seu backend é avisado quando ela estiver no ar.

15 a day

Posts de vídeo que o TikTok publica por conta pela sua API for Business, no máximo seis por minuto.

1 GB

Maior vídeo que o endpoint de publicação do TikTok aceita, em MP4, MOV ou WebM, de 3 a 600 segundos.

35 images

Máximo de imagens que cabem em uma foto do TikTok; cada uma em JPG, JPEG ou WebP, de até 20 MB.

90

Unidades de código UTF-16 que o título de uma foto do TikTok pode ter.

90 days

Com quanta antecedência o endpoint de posts da easyCoexistence pode agendar um post no TikTok.

Como um cliente conecta o TikTok?

Por uma sessão de conexão com channel definido como tiktok. A página hospedada mostra o nome da sua empresa e o botão Continuar com TikTok, que abre a tela de consentimento do próprio TikTok na mesma aba; o cliente entra, permite o acesso e volta para o seu redirect_url com um channel_id. Guarde esse valor junto ao cliente, já que toda chamada de post informa o canal.

Como é uma requisição de post no TikTok?

Um POST para /channels/{id}/posts, com a legenda em text e o arquivo em media. Omita publish_at para publicar agora, ou defina um horário ISO 8601 com o seu deslocamento para publicar depois. Um post para agora responde 201, ou 422 com 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"
  }'

Post de vídeo ou de foto: o que cada um exige?

Um post no TikTok é um vídeo ou um conjunto de imagens, nunca os dois, e não carrega link. O texto, de até 2.200 caracteres aqui, é a legenda nos dois casos, e as regras de arquivo do próprio TikTok são verificadas antes de o post entrar na 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 a mídia precisa estar?

Em qualquer endereço HTTPS ou no armazenamento da easyCoexistence. O TikTok baixa apenas de prefixos de URL verificados para o app, então a easyCoexistence serve cada arquivo a partir do seu próprio prefixo verificado e você não precisa verificar nada. A mídia de um post agendado é copiada no momento do agendamento, com imagens de até 30 MB e vídeos de até 1 GB, então um link que morre antes do horário do post não pode quebrá-lo. Para enviar um arquivo, POST /media retorna um media_id.

Como saber que um post está no ar?

Pelo status do post e pelos eventos. Um post passa de scheduled para publishing, depois para processing enquanto o TikTok baixa e verifica o arquivo; a easyCoexistence consulta o TikTok a cada 20 segundos até ele informar que o post está concluído. Sua URL de eventos então recebe post.published com o post e seu 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 edições, cancelamentos e repetições?

No próprio post, enquanto o TikTok ainda não o tem. PATCH /posts/{id} altera publish_at, text ou title em um post agendado; para trocar a mídia, cancele com DELETE /posts/{id} e crie outro. POST /posts/{id}/retry publica de novo um post que falhou. Quando o TikTok não confirma em 2 horas, o post falha com may_be_published true, e a repetição exige confirm definido como true.

O que acontece com os comentários após o post?

Eles podem chegar ao seu produto. PUT /channels/{id}/webhook encaminha os eventos comment.update do TikTok ao seu endpoint, assinados, e o seu backend responde ao comentário pelo business/comment/reply/create/ do TikTok, com o token da chamada de credenciais. Respostas no TikTok são públicas, já que uma conexão com o TikTok não tem DMs.

Erros comuns

  • Enviar imagens em PNG para uma foto. O TikTok aceita apenas JPEG ou WebP, então o post é recusado antes de entrar na fila.
  • Colocar um title em um post de vídeo. title serve para fotos, e um vídeo leva seu texto apenas na legenda.
  • Repetir um post com may_be_published true sem conferir. O TikTok pode já tê-lo publicado, então verifique a conta antes de repetir com confirm.
  • Planejar mais de 15 posts por dia para uma conta. O TikTok limita posts via API por conta, então distribua o calendário do cliente por vários dias.
Fazendo isso com o EasyCoexistence

A easyCoexistence adiciona postagens no TikTok ao seu SaaS: seus clientes conectam as contas TikTok por um link hospedado, e seu backend publica vídeos e fotos agora ou depois, fica sabendo quando cada um está no ar e recebe os comentários. A mesma API cobre WhatsApp, Instagram, Facebook, YouTube, LinkedIn e mais canais, com cada conexão monitorada 24/7. De US$ 9 até US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Meu SaaS pode publicar vídeos do TikTok como rascunhos?

Não. O endpoint de posts da easyCoexistence publica o vídeo na conta, de imediato ou em publish_at. Use o agendamento para segurar um post até o cliente estar pronto.

O TikTok permite agendar posts pela API dele?

Os endpoints de publicação do TikTok agem no momento em que são chamados. A easyCoexistence mantém o post na sua fila e chama o TikTok em publish_at, com até 90 dias de antecedência.

Meu SaaS pode desativar os comentários de um post no TikTok?

Sim. Defina disable_comment como true no post. Quando as próprias configurações da conta já desligam os comentários, o TikTok aceita apenas true.

Quanto custa a easyCoexistence por conta do TikTok?

Cada conta do TikTok que seus clientes conectam custa de US$ 9 até US$ 0.75 por mês, conforme a faixa do total de conexões, com os 3 primeiros dias grátis.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

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

Verificado em