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.
Posts de vídeo que o TikTok publica por conta pela sua API for Business, no máximo seis por minuto.
Maior vídeo que o endpoint de publicação do TikTok aceita, em MP4, MOV ou WebM, de 3 a 600 segundos.
Máximo de imagens que cabem em uma foto do TikTok; cada uma em JPG, JPEG ou WebP, de até 20 MB.
Unidades de código UTF-16 que o título de uma foto do TikTok pode ter.
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.
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 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 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.
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