Chaves de API

Chaves permitem que outro sistema (ERP, Salesforce, n8n, um assistente de IA) acesse sua conta.

Criar uma chave

1. No painel, abra API.
2. Clique em Criar chave, dê um nome que identifique a integração (ex.: Salesforce produção) e marque só as permissões necessárias.
3. Copie a chave na hora. Ela começa com pk_live_ e não será mostrada de novo.

Permissões

Permissão	Libera
customers:read	Listar e buscar clientes e veículos (inclusive pela placa)
customers:write	Cadastrar e alterar clientes e veículos
service_orders:read	Ler OS, orçamento, etapas, quadro do pátio, quadro por técnico e equipe
service_orders:write	Abrir e alterar OS, itens do orçamento, mudar etapa e atribuir técnico
webhooks:manage	Cadastrar e remover webhooks

Boas práticas

• Uma chave por integração: se uma vazar, você revoga só ela.
• Guarde a chave em cofre de segredos (no Salesforce: Named Credential), nunca no código.
• Revogar desativa a chave na hora.