API Keys
Uma API Key permite que outro sistema envie mensagens pela plataforma — uma automação no n8n, um fluxo no Zapier, um script do seu ERP.
Gerar
- Vá em Configurações › API Keys.
- Dê um nome que identifique quem vai usar: "n8n - confirmação de pedido". Daqui a seis meses, "chave 1" não diz nada.
- Se quiser, escolha um canal. Com o canal selecionado, o exemplo de comando já vem pronto.
- Clique em Gerar key.
Resultado esperado: a chave aparece e passa a constar em Keys ativas.
Como se usa
A chave vai no cabeçalho X-API-Key das requisições, para o endereço de envio de mensagens que a própria tela mostra.
Quem cuida da integração vai reconhecer o formato — a tela oferece um exemplo pronto de comando para copiar.
Cuide dela como de uma senha
Uma chave dá acesso ao envio pelo seu canal. Nas mãos erradas, alguém manda mensagem em nome da sua empresa.
- Copie no momento em que gerar e guarde num lugar seguro.
- Nunca coloque em código publicado, planilha compartilhada ou mensagem de grupo.
- Uma chave por integração. Assim, quando uma vazar ou a ferramenta sair de uso, você revoga só ela.
- Revogue o que não usa. Chave esquecida de um sistema desligado é porta aberta sem motivo.
Dúvidas comuns
Perdi a chave. Como recupero? Não recupera. Gere outra e atualize a integração.
A integração parou de funcionar. Confira se a chave ainda consta em Keys ativas e se o canal continua ativo.
Quem pode gerar? Depende da permissão do perfil — normalmente, administradores.
A chave expira? Ela vale até ser revogada. Por isso a limpeza periódica importa.