Como Conectar o Nivro a Outros Sistemas (API)
Gere um token de API para conectar o Nivro a Zapier, ERPs, planilhas e outras ferramentas
Como Conectar o Nivro a Outros Sistemas (API)
Para quem é este artigo
OWNER — apenas o proprietário da conta pode gerar tokens de API.
O que você vai aprender
- O que é a API do Nivro e para que serve
- Como gerar um token de acesso
- Boas práticas de segurança
- Exemplos de uso comuns
1. O que é a API do Nivro?
A API permite que outras ferramentas leiam e criem dados no Nivro automaticamente, sem precisar de alguém acessando o sistema manualmente. É o mesmo recurso usado por integrações do tipo Zapier, n8n, planilhas automatizadas, ERPs e sistemas de contabilidade.
Alguns exemplos do que dá para fazer:
- Sincronizar pedidos de um e-commerce direto para o Nivro.
- Exportar vendas automaticamente para uma planilha ou sistema contábil.
- Disparar uma automação no Zapier ou n8n sempre que uma venda for registrada.
- Conectar o Nivro a um ERP já usado pela empresa.
2. Como gerar um token de API
- Acesse Configurações → API e Integrações.
- Clique em Criar token.
- Dê um nome que identifique a integração (ex.: "Integração ERP", "Planilha de vendas").
- Escolha o nível de permissão do token — funciona igual ao nível de um usuário da equipe:
- Visualizador: só consegue ler dados (recomendado para a maioria das integrações de leitura, como planilhas e relatórios).
- Operador: pode criar vendas, pedidos e clientes, além de ler dados.
- Gerente e Proprietário: acesso mais amplo — use somente se a integração realmente precisar.
- Clique em Criar token e copie o valor exibido na hora. Por segurança, ele não é mostrado novamente.
- Cole o token na ferramenta externa (no campo de "API Key" ou "Bearer Token" dela).
3. Segurança: trate o token como uma senha
- Qualquer pessoa com o token consegue acessar os dados do seu Nivro dentro do nível de permissão escolhido.
- Nunca compartilhe um token por e-mail, chat ou qualquer canal não seguro.
- Se desconfiar que um token vazou, revogue-o imediatamente em Configurações → API e Integrações — isso derruba o acesso na hora, sem afetar os outros tokens.
- Prefira o nível de permissão mais baixo que atenda à integração (na dúvida, comece com Visualizador).
4. Revogando um token
Na mesma tela onde os tokens foram criados, cada um tem um botão Revogar. Depois de revogado, qualquer chamada feita com aquele token para de funcionar imediatamente — a integração externa vai precisar de um token novo para continuar funcionando.
5. Quer implementar a integração?
Este artigo cobre a parte de criar e gerenciar o token dentro do Nivro. Se você (ou o time técnico da ferramenta que está conectando) vai efetivamente programar a integração — endpoints disponíveis, formato das requisições, limites de uso — a referência técnica completa está em nivro.app/desenvolvedores.