Suporte: seg. a sex., das 9h às 18h

Como gerar tokens da API Braavo!

Atualizado em 05/10/2026

A tela API Braavo! cria as credenciais que um sistema externo precisa para se comunicar com a sua loja. É o ponto de partida de qualquer integração: um ERP, um aplicativo próprio, um serviço contratado ou qualquer software que precise ler ou gravar pedidos, produtos, estoques e clientes pela API.

A tela fica em ERPs > API Braavo! e o acesso é restrito a administradores de nível 1.

Para entender como a API funciona, os verbos disponíveis, o limite de chamadas e como os webhooks se encaixam no fluxo, leia Onde encontrar o manual da API e dos Webhooks da Braavo.

Criando um token

Clique em Adicionar e preencha:

  • Nome do Serviço — identifica para que serve este token, como "ERP Bling" ou "App próprio". Um nome claro facilita a gestão quando há mais de uma integração ativa ao mesmo tempo.
  • 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.

Configurando o Webhook

O webhook faz o caminho inverso da API: em vez de o sistema perguntar o que mudou, a loja avisa proativamente. Quando ativado, a loja envia uma requisição automática para a URL cadastrada quando um pedido é criado, quando ele muda de status de pagamento ou de entrega, quando recebe o código de rastreio e quando um carrinho é abandonado.

  • Ativo — liga ou desliga o envio de eventos para este token.
  • URL do Webhook (para Pedidos) — endereço no seu sistema que receberá os avisos. A URL precisa estar no ar, aceitar requisições POST e responder com um código de sucesso (família 2xx) para confirmar o recebimento. Todos os avisos vão para esta mesma URL, inclusive o de carrinho abandonado.

O interruptor geral dos webhooks

Além do webhook de cada token, existe um interruptor que vale para a loja inteira: o botão Ajustes da lista de tokens abre a tela Webhooks da API, com o interruptor Enviar os webhooks de pedido e o selo Ativos ou Desligados. A tela também aparece em Todos os Ajustes, na seção ERPs.

Atenção: com o interruptor geral desligado, nenhum webhook sai, mesmo nos tokens com o webhook ativo. A lista de tokens mostra um aviso amarelo nesse caso. Se os webhooks pararem de chegar sem motivo aparente, confira esse interruptor primeiro.

Anotando as credenciais

Ao salvar, a plataforma exibe uma única vez o API Token e o API Key. Esse é o único momento em que o API Key aparece em texto.

  • API Token — funciona como o identificador do usuário na autenticação Basic.
  • API Key — funciona como a senha. Nunca é exibido novamente após esta tela.

Atenção: anote os dois antes de sair. Se perder o API Key, o caminho é criar um token novo e atualizar a integração com as novas credenciais. O link para o manual técnico da API também aparece nessa tela, para facilitar o repasse ao responsável pela integração.

Editando um token

É possível atualizar o nome do serviço, o e-mail do responsável e a configuração de webhook a qualquer momento. Editar um token não altera o API Token nem o API Key, que são gerados apenas na criação.