Requisito:
Acesso à tela de API (restrito a administradores de nível 1. Se o seu usuário não tiver esse nível, solicite ao responsável pela loja).
Passo 1: Acessar o painel da loja (login)
Acesse https://site.braavo.com.br/login (ou o endereço do painel da sua loja).
Informe e-mail e senha cadastrados e avance. Também é possível usar Fazer login com o Google, se for o caso da sua conta.
Se a sua loja tiver autenticação por dois fatores (2FA) ativada, abra o aplicativo autenticador no celular e digite o código de 6 dígitos solicitado. O código muda a cada 30 segundos.
Passo 2: Abrir a tela API Braavo!
Já no painel, no menu lateral, vá em ERPs.
Clique em API Braavo!.
É nessa tela que ficam todos os tokens de integração da loja.
Passo 3: Criar o token
Clique em Adicionar.
Preencha os campos:
Nome do Serviço — use algo que identifique a integração, por exemplo: "Adstart". Um nome claro facilita a gestão quando há mais de uma integração ativa.
E-mail do Técnico Responsável — recebe notificações urgentes de segurança relacionadas a este token. Use o contato de quem cuida da integração da sua parte (pode ser o mesmo e-mail do administrador).
3. Salve.
Passo 4: (Opcional) Configurar o webhook
O webhook faz o caminho inverso da API: em vez da Adstart perguntar o que mudou, a loja avisa automaticamente. Se a equipe Adstart solicitar:
Ativo — deixe ligado para o envio de eventos.
URL do Webhook (para Pedidos) — informe a URL que a equipe Adstart passar. Ela precisa estar no ar, aceitar requisições POST e responder com código de sucesso (2xx).
> Atenção: existe um interruptor global de webhooks em Ajustes, acessível pela lista de tokens. Quando ele está desligado, nenhum webhook é disparado. Se os webhooks pararem de funcionar sem motivo aparente, verifique esse interruptor primeiro.
Passo 5: Anotar o API Token e o API Key (importante!)
⚠️ Ao salvar, a plataforma exibe uma única vez as credenciais da integração:
API Token — funciona como o identificador do usuário na autenticação.
API Key — funciona como a senha.
> Atenção: o API Key nunca mais é exibido. Anote os dois antes de sair da tela. Se o API Key for perdido, será preciso criar um token novo e reenviar as credenciais para a Adstart.
Passo 6: Cadastrar as credenciais na plataforma Adstart
Acesse o seu e-commerce.
Acesse as configurações:
Acesse a tela de Integração com e-commerce:
Clique no ícone para editar sua plataforma:
Selecione a plataforma Braavo:
Preencha os campos:
URL: Link do e-commerce da loja
API Token: Token gerado na Braavo
API Key: Key gerada na Braavo
Salvar Alterações.
Dúvidas frequentes:
Perdi o API Key. E agora?
Não há como recuperá-lo. Crie um token novo em ERPs > API Braavo! e envie as novas credenciais para a Adstart.
Posso editar o token depois?
Sim — nome do serviço, e-mail do responsável e webhook podem ser atualizados a qualquer momento. A edição não altera o API Token nem o API Key.
A edição ou recriação do token derruba a integração?
Editar não. Criar um token novo não desativa o antigo; a Adstart apenas passa a usar as novas credenciais.
Onde está a documentação técnica completa da API?
Em https://manual.braavo.com.br (REST + JSON, autenticação Basic com API Token e API Key).
Dúvidas?
Entre em contato com o time da Adstart.