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
Clique em Nova chave. O formulário abre num painel ao lado.
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.
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.
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.
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.