Autenticação
Como criar, usar e revogar uma chave
Toda chamada leva a chave no cabeçalho:
Authorization: Bearer ib_live_...Sem ela, ou com uma chave revogada, a resposta é 401.
Criar a chave
No painel, em Configurações → Chaves de API. A aba só aparece para quem é membro da conta: quem gerencia apenas uma empresa não emite chave, porque a chave alcança todas as empresas da conta.
Dê um nome que diga onde ela é usada, como "Integração n8n". É o que vai permitir revogar a certa quando alguma parar de ser necessária.
A chave aparece uma vez só
No momento em que você cria, e nunca mais. Guardamos apenas um resumo e um hash: não existe forma de recuperar o valor depois, nem pelo suporte.
Se perder, revogue e crie outra. É rápido e não afeta as demais.
Guarde em variável de ambiente ou no cofre de segredos que você já usa:
export INTELIBOT_CHAVE="ib_live_..."Onde a chave nunca deve estar
No navegador. A chave é segredo de servidor e vale para a conta inteira. Por isso as rotas da API não respondem a requisições vindas de página web: não enviamos cabeçalho de CORS, e o navegador bloqueia a chamada.
Se você precisa que um front-end converse com o agente, use o widget ou a página de atendimento, que existem para isso e não expõem credencial.
Revogar
Na mesma tela, no botão Revogar. O efeito é imediato: a próxima chamada com
aquela chave recebe 401.
A chave revogada continua listada, com a data. É registro de auditoria: dá para ver quando ela foi usada pela última vez antes de morrer.
Se uma chave vazar
Revogue primeiro, investigue depois. Uma chave dá acesso a todas as empresas da sua conta, incluindo o histórico de conversas, que costuma ter dado pessoal de cliente final.
Depois de revogar, crie outra e atualize a integração. Nada mais precisa mudar.