> Crie chaves para conectar BI, planilhas e automações aos dados da sua organização, com permissões escolhidas por você, e revogue quando não precisar mais. # Chaves de API Uma chave de API conecta uma ferramenta externa, como Power BI, Metabase, Looker, uma planilha ou um script próprio, aos dados **desta organização**, e só ao que você marcar nas permissões dela. ## Onde fica Menu **Configurações › Chaves de API**. Ver a lista exige a permissão **`integracoes:view`**; criar e revogar exigem **`integracoes:edit`**. Sem ela, a tela mostra a lista, mas não oferece **Nova chave** nem **Revogar**. ## A lista No topo, uma frase resume a tela: quantas chaves estão ativas, quantas foram revogadas e quantas foram usadas nos últimos 30 dias. Abaixo, uma linha por chave: o nome, as permissões dela por extenso, o começo da chave e quando foi usada pela última vez (ou **Nunca usada**). As revogadas continuam na lista, no fim, com a data em que foram revogadas. A chave que vence em menos de 14 dias, ou que já venceu, ganha uma **régua de atenção** ao lado. Chave parada há muito tempo não ganha: o registro de último uso pode deixar de ser gravado sem aviso, e revogar só por ele pode derrubar uma integração que funciona. Antes de revogar, confirme com quem integrou. ## Criar uma chave 1. Clique em **Nova chave**. O formulário abre num painel ao lado. 2. Em **Para que serve**, escreva o sistema e o dono, como "Power BI do financeiro". É só por esse nome que você vai reconhecer a chave depois, e com duas integrações parecidas ele é o que diz qual revogar. Cabem 60 caracteres. 3. Em **O que ela pode fazer**, marque as permissões. Marque só o que a integração precisa: - **Leitura para BI**: lê conversas, mensagens, CSAT e atendentes, só leitura. É a permissão para ferramentas de relatório. - **Configuração do agente**: lê e **altera** a configuração do agente de IA. Dá poder de mudar como o agente fala com o cliente. - **Ferramentas da telefonia**: deixa o atendimento por voz agir no sistema do provedor (consultar cadastro, abrir chamado, agendar visita, desbloquear, reiniciar equipamento). É a mais poderosa. 4. Clique em **Criar chave**. A chave aparece **uma única vez**, no próprio painel. Clique em **Copiar a chave**, guarde num lugar seguro e só então clique em **Já copiei**. > **Atenção.** > A chave não é mostrada de novo. Guardamos só um resumo dela, então não há como recuperá-la: se perder, revogue e crie outra. E quem tem a chave tem acesso aos dados que ela permite, por isso não a envie por WhatsApp nem por e-mail. ## Ver e revogar Clique numa chave para abrir o painel com o começo dela, quando foi criada, a última vez que foi usada, a validade e o que ela pode fazer. **Revogar** fica nesse painel e pede confirmação. A ferramenta que usa a chave para de funcionar na hora, e isso não pode ser desfeito. A chave continua na lista como revogada: é a trilha que permite responder, numa auditoria, que ela existiu, até quando foi usada e quando foi desligada. ## Veja também - [Grupos & permissões](/configuracoes/grupos-e-permissoes) - [Auditoria](/configuracoes/auditoria)