Para criar:
1. Vá em Empresa → Integrações.
2. Clique em Nova chave.
3. Dê um nome que lembre para que ela é (ex.: "ERP do escritório").
4. Marque só os acessos necessários — a tela já vem com o mínimo marcado.
5. Clique em criar.
⚠️ A chave aparece uma única vez. Copie e entregue ao seu desenvolvedor na hora. Se perder, não tem como recuperar: gere outra e revogue a antiga.
Sobre os acessos (escopos): cada um libera uma parte. Se a integração só vai ler clientes, marque apenas leitura de clientes — assim, se a chave vazar, o estrago é menor. Acesso ao financeiro é o mais sensível: só marque se a integração realmente for mexer em contas.
Revogar: na mesma tela, o botão de revogar corta o acesso na hora. Faça isso se trocar de fornecedor de software ou se desconfiar que a chave vazou.
Quantas chaves posso ter? Até 5 ativas por empresa. Mais que isso costuma ser sinal de chave esquecida — revogue as que não usa.
Quem pode criar chave: assinante e gerente. Operador de caixa não vê essa tela, porque uma chave dá acesso ao financeiro inteiro.
O que mais entregar ao desenvolvedor: na mesma tela existe o botão Arquivo PHP pronto. É um arquivo único, sem instalação, que já resolve autenticação, paginação, novas tentativas e a conferência de assinatura dos webhooks — se o sistema dele for PHP, mande junto com a chave.