Conectar o TikTok Shop
Conecte sua loja TikTok Shop ao ManarIA para centralizar pedidos
O que e a integracao TikTok Shop
O TikTok Shop e o canal de vendas integrado ao TikTok, onde vendedores publicam produtos e consumidores compram diretamente pelo aplicativo. A integracao do ManarIA com o TikTok Shop permite que voce receba e gerencie pedidos dessa plataforma de forma centralizada, sem precisar acessar o TikTok Seller Center separadamente.
A conexao e feita via OAuth pela TikTok Shop Partner API. O ManarIA utiliza os tokens de acesso para operar em seu nome, consultando pedidos, recebendo atualizacoes via webhooks e permitindo o gerenciamento do fluxo de vendas dentro da plataforma.
Pre-requisitos
Antes de conectar, certifique-se de que voce tem:
- Conta de vendedor ativa no TikTok Shop (TikTok Seller Center)
- Loja aprovada e publicada no TikTok Shop Brasil
- Acesso ao e-mail ou numero de telefone vinculado a conta TikTok
Nota: O TikTok Shop esta disponivel para vendedores no Brasil. Caso sua conta ainda esteja em analise ou pendente de aprovacao, aguarde a liberacao antes de tentar conectar.
Como conectar
- No ManarIA, acesse o menu Marketplaces na barra lateral
- Clique no botao Nova Integracao (canto superior direito)
- Na janela que abre, selecione TikTok Shop (marcado como Disponivel)
- Digite um prefixo identificador para esta conta, usando apenas letras e numeros. Exemplos:
TIKTOK1,LOJATK,PRINCIPAL- O prefixo identifica a conta internamente no ManarIA
- Escolha algo curto e memoravel, especialmente se voce tiver mais de uma loja
- Clique em Continuar para TikTok Shop
- Voce sera redirecionado para a pagina de autorizacao do TikTok Shop
- Faca login na sua conta do TikTok Seller Center se necessario
- Revise as permissoes solicitadas pelo ManarIA e clique em Confirmar
- Aguarde o redirecionamento automatico de volta ao ManarIA
- Uma notificacao confirmara que a conta foi conectada com sucesso
Apos a conexao, a conta aparecera na lista de Marketplaces com o status Autenticada (badge verde).
O que e sincronizado
A integracao com o TikTok Shop foca no gerenciamento de pedidos e notificacoes em tempo real:
Pedidos
- Recebimento de novos pedidos em tempo real via webhooks
- Atualizacoes automaticas de status ao longo do ciclo de vida do pedido
- Informacoes do comprador e endereco de entrega
- Itens comprados, quantidades e valores
- Numero de rastreamento e dados de logistica
- Notificacoes de cancelamento e solicitacoes de devolucao
Webhooks suportados
O ManarIA configura automaticamente os seguintes eventos de notificacao do TikTok Shop:
| Evento | Descricao |
|---|---|
| Novo pedido | Disparado quando um cliente finaliza uma compra |
| Atualizacao de pedido | Mudancas de status no ciclo do pedido |
| Pedido enviado | Confirmacao de despacho com dados de rastreamento |
| Pedido entregue | Confirmacao de entrega ao cliente |
| Cancelamento | Pedido cancelado pelo cliente ou pela plataforma |
| Devolucao/Reembolso | Solicitacao de devolucao iniciada |
| Atualizacao de produto | Mudancas em produtos (aprovacao, suspensao) |
Regioes suportadas
A API do TikTok Shop suporta multiplas regioes. O ManarIA esta configurado para operar com lojas no Brasil (BR), que e a regiao principal dos vendedores brasileiros.
Status da conexao
Na pagina de Marketplaces, cada conta TikTok Shop exibe:
- Status: Autenticada (verde) ou Nao autenticada (vermelho)
- Credenciais: Dias restantes ate a expiracao do token de acesso
- Identificador: O ID externo da sua loja na TikTok Shop Partner API
- Ultima Atualizacao: Data e hora da ultima sincronizacao registrada
O token de acesso do TikTok Shop tem validade limitada. Quando o prazo se aproximar, o ManarIA exibira um aviso para que voce reconecte a conta antes que as sincronizacoes sejam interrompidas.
Dicas
- Prefixo unico por loja: Se voce administra mais de uma loja TikTok Shop, use prefixos diferentes para cada uma, como
TK1eTK2, para facilitar a identificacao na lista de integrações - Mantenha a conta TikTok ativa: O token OAuth esta vinculado a sua conta TikTok Seller Center. Se voce alterar a senha ou revogar permissoes pelo painel do TikTok, sera necessario reconectar
- Verifique as permissoes: Na tela de autorizacao, o TikTok exibe quais dados o ManarIA solicitara acesso. Aceite todas as permissoes listadas para garantir o funcionamento completo da integracao
- Fique atento ao prazo do token: Acesse periodicamente a pagina de Marketplaces e verifique a coluna Credenciais. Se aparecer menos de 7 dias, reconecte a conta com antecedencia
Problemas comuns
| Problema | Causa provavel | Solucao |
|---|---|---|
| Redirecionamento nao ocorre ao clicar em "Continuar para TikTok Shop" | Erro de rede ou sessao expirada | Recarregue a pagina e tente novamente |
| "Erro ao iniciar OAuth" | Configuracao do app TikTok invalida ou expirada | Entre em contato com o suporte do ManarIA |
| Conta aparece como "Nao autenticada" logo apos conectar | Autorizacao negada ou token nao retornado | Delete a conta e reconecte pelo fluxo de Nova Integracao |
| Pedidos do TikTok Shop nao chegam ao ManarIA | Webhook desconfigurado ou URL inacessivel | Verifique as configuracoes da conta e entre em contato com o suporte se necessario |
| Token expirou antes do prazo esperado | Permissao revogada manualmente no TikTok Seller Center | Acesse o TikTok Seller Center, verifique apps autorizados e reconecte |
| Erro 429 ao sincronizar | Limite de requisicoes da API atingido (50 por segundo por loja) | O ManarIA realiza retry automatico; aguarde alguns segundos e a sincronizacao se retoma |
| Loja nao aparece nas opcoes durante OAuth | Conta TikTok nao tem loja vinculada ou loja ainda em aprovacao | Verifique o status da loja no TikTok Seller Center antes de conectar |