Integração com TikTok API for Business
SmartWay Portal — LEAD EMPREENDIMENTO DIGITAIS LTDA
Esta página descreve uma integração em preparação para análise. Ela não declara que a SmartWay Portal seja parceira, certificada ou aprovada pelo TikTok.
Responsável
A SmartWay Portal é operada por LEAD EMPREENDIMENTO DIGITAIS LTDA, empresa brasileira inscrita no CNPJ 51.340.668/0001-19, com sede em Cuiabá – MT, Brasil. Site oficial: https://smartwayportal.com/. Contato: contact@smartwayportal.com.
Finalidade
A integração pretende permitir que o administrador conecte contas publicitárias autorizadas por meio do fluxo OAuth do TikTok API for Business e consulte informações necessárias à gestão de publicidade digital. O acesso é privado, não existe cadastro público e nenhuma conta deve ser conectada sem autorização do titular.
Funcionalidades implementadas
- início e retorno do fluxo OAuth, com estado de uso único e troca do código no servidor;
- armazenamento cifrado do token no backend e associação às contas publicitárias autorizadas;
- consulta de contas, campanhas, grupos de anúncios, anúncios, identidades e pixels;
- consulta autenticada de acesso a Business Center e de informações de catálogos;
- painel com campanhas, grupos, métricas integradas, filtros, CSV e histórico;
- pausa manual controlada e monitor em simulação; e
- endpoints protegidos para criar, ativar ou desativar campanhas, grupos e anúncios, sem interface completa de criação.
Recursos não disponíveis na interface atual
Não existe cadastro público, gestão multiempresa, segregação por cliente, biblioteca/upload de mídia, gestão visual de públicos, pixels ou catálogos, nem assistente visual para criação ou cópia de campanhas. Relatórios exibidos no painel dependem da integração de métricas configurada; o código atual não implementa diretamente o endpoint de Reporting do TikTok.
Dados e segurança
A aplicação pode tratar IDs de contas e objetos publicitários, configurações, status, métricas, tokens OAuth e registros técnicos. Tokens e segredos permanecem no servidor, em variáveis de ambiente ou armazenamento cifrado, e não são expostos ao navegador. Operações exigem sessão administrativa, proteção contra requisições indevidas e associação da conta à autorização registrada.
Permissões
A solicitação deve se limitar às categorias necessárias para autenticação de anunciantes e leitura das contas, campanhas, grupos e anúncios. Permissões de alteração devem ser solicitadas apenas se a pausa e o gerenciamento controlado forem incluídos no caso de uso submetido. Acesso a Business Center, identidades, pixels ou catálogos deve ser incluído somente se essas funções forem demonstradas e necessárias. Permissões de públicos, upload criativo e Reporting não devem ser solicitadas com base apenas em módulos planejados.
OAuth e revogação
Callback previsto para o domínio oficial: https://smartwayportal.com/oauth/callback/. A URL deve ser registrada exatamente assim no aplicativo, incluindo HTTPS e a barra final. O titular pode recusar ou revogar permissões pelos controles do provedor. Solicitações relacionadas à plataforma podem ser enviadas a contact@smartwayportal.com.
Documentos
Política de Privacidade · Termos de Uso · Privacy Policy · Terms of Use