EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Testando a API do TikTok antes da aprovação: o sandbox

O modo sandbox do TikTok for Developers permite testar a integração de um app antes de enviá-lo para revisão: até 5 sandboxes, cada uma com configuração separada do app ativo, testadas por até 10 contas de usuários de teste que entram com o próprio login. Ficam de fora a Content Posting API para vídeos públicos e a Data Portability API.

O easyCoexistence conecta uma conta do TikTok que você possui entrando no TikTok, pelo app de desenvolvedor próprio da API for Business, para que você possa testar publicações, comentários e métricas a partir do Claude, ChatGPT ou do seu próprio código, sem sandbox nem revisão de app sua.

5 sandboxes

Número máximo de sandboxes que o TikTok for Developers permite criar, para testar integrações sem enviar o app para revisão.

10 accounts

Número máximo de usuários de teste que você pode adicionar; adicionar uma conta que você possui exige suas credenciais de login.

Dec 1, 2026

Quando o TikTok descontinua contas sandbox da API for Business, orientando os desenvolvedores a criar uma conta de teste em produção.

30 QPM

Limite por endpoint nas contas sandbox da API for Business, além de uma consulta por segundo e 1.000 por dia.

1 hour

Tempo que novos usuários de teste adicionados podem levar para aparecer na página do app após uma atualização.

Qual é o modo sandbox do TikTok?

Um ambiente restrito em developers.tiktok.com onde a integração de um app roda antes da revisão. O TikTok o descreve como uma forma de testar integrações sem enviar o app e de experimentar configurações sem comprometer a versão ativa. Cada sandbox mantém seus próprios detalhes do app e produtos, e os usuários de teste que você adiciona o experimentam.

Como criar um sandbox?

Na página do app no portal de desenvolvedores. Os passos do TikTok, depois de ter uma conta de desenvolvedor, para a qual criar ou entrar em uma organização é recomendado, mas não obrigatório:

  • Abra Manage apps, selecione ou conecte o app e mude o alternador ao lado do nome dele para Sandbox.
  • Clique em Create Sandbox, dê um nome e, se quiser, clone a versão de produção ou outro sandbox.
  • Edite App details, adicione os produtos a testar e clique em Apply changes.
  • Adicione mais com o botão [+] no painel à esquerda, até 5 no total.

Como funcionam os usuários de teste?

São as contas do TikTok que testam o sandbox. Em Sandbox settings, Target users, escolha Add account, entre com a conta e aceite os Termos de Serviço para Desenvolvedores do TikTok. O TikTok informa que uma conta que você possui precisa de suas credenciais de login para ser adicionada, e que novos usuários podem levar até uma hora para aparecer após uma atualização. Podem ser adicionados até 10, que depois podem ser autorizados pelo Login Kit e pelos produtos que dependem dele, com um decodificador de URL necessário nesse passo.

O que o modo sandbox deixa de fora?

Publicação pública e portabilidade de dados. A página de sandbox do TikTok afirma que o modo não oferece acesso à Content Posting API para vídeos públicos nem à Data Portability API. Publicações públicas também dependem de mais do que a revisão: até que um cliente da Content Posting API seja aprovado na auditoria do TikTok, ele publica em visibilidade SELF_ONLY, a partir de contas privadas, para até 5 usuários em 24 horas.

Como o sandbox se encaixa na revisão do app?

É dele que vem a demonstração de uma primeira submissão. As diretrizes de revisão do TikTok exigem que um app nunca aprovado demonstre sua integração em um sandbox no Developer Portal. Uma configuração de sandbox pode então ser importada para um Draft no modo Production, o que sobrescreve esse draft, e Revert to Live version retorna à configuração aprovada.

Existe sandbox na API for Business?

Existe um, para anúncios, e ele está sendo descontinuado. As contas sandbox da API for Business são contas de anúncios, acessadas em https://sandbox-ads.tiktok.com/open_api com dados de relatório simulados, uma por app de desenvolvedor, e limitadas a uma consulta por segundo, 30 por minuto e 1.000 por dia em cada endpoint. Os endpoints suportados cobrem campanhas, grupos de anúncios, anúncios, uploads de criativos, relatórios, termos e identidades, sem nenhum endpoint da Accounts API em business/, e o TikTok os descontinua até 1º de dezembro de 2026, orientando o uso de uma conta de teste em produção.

Como testar a Accounts API sem sandbox?

Em uma conta real que você possui e mantém para testes. Autorize o app com essa conta, verifique os escopos do token com /tt_user/token_info/get/ e teste a publicação com a URL de vídeo de teste que o TikTok fornece para /business/video/publish/, que não exige verificação de URL. O guia de primeiros passos do TikTok também indica a coleção Postman da API for Business para testar chamadas. Publicações de teste contam para os limites dessa conta, de seis por minuto e 15 por dia.

Como o easyCoexistence se encaixa nos testes?

Sem nada para configurar do lado do TikTok. Uma conta do TikTok que você possui se conecta ao easyCoexistence entrando no TikTok, pelo app de desenvolvedor da API for Business do próprio easyCoexistence, então não há nenhuma sandbox, revisão ou auditoria sua para esperar. Claude, ChatGPT ou o código da sua plataforma então publicam, respondem a comentários e leem métricas nessa conta pelas mesmas ferramentas que as contas dos seus clientes usarão.

Erros comuns

  • Planejar testes de publicação pública em um sandbox. O modo sandbox não oferece a Content Posting API para vídeos públicos.
  • Adicionar um usuário de teste sem o login. O TikTok pede as credenciais de uma conta que você possui ao adicioná-la como usuário de teste.
  • Começar novos testes em contas de anúncios sandbox da API for Business. O TikTok as descontinua até 1º de dezembro de 2026 e aponta para contas de teste em produção.
  • Enviar um app nunca aprovado sem gravação de sandbox. As diretrizes do TikTok exigem uma demonstração da integração em sandbox para a primeira revisão.
Fazendo isso com o EasyCoexistence

De US$ 9 a 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

Por que meus usuários de teste do TikTok não aparecem?

O TikTok informa que novos usuários de teste podem levar até uma hora para aparecer na página do app após uma atualização. Adicionar uma conta que você possui também exige suas credenciais de login.

Um sandbox do TikTok precisa de um app de desenvolvedor separado?

Não. Os sandboxes ficam dentro do mesmo app em developers.tiktok.com, até 5, cada um com seus próprios detalhes do app e produtos, separados da versão ativa.

Publicações de teste em uma conta real do TikTok contam para os limites dela?

Sim. Publicações feitas ao testar a Accounts API em uma conta real contam para os limites de seis por minuto e 15 por dia, como qualquer outra publicação.

O que um vídeo de demonstração do sandbox do TikTok deve mostrar?

A integração de ponta a ponta, com cada escopo solicitado em uso. As diretrizes de revisão do TikTok pedem que um app nunca aprovado a demonstre em sandbox, e uma demonstração que pule o fluxo ou algum escopo é um motivo comum de rejeição.

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