Chaves API e autenticação
O Atendia MCP usa as chaves API da tua organização. Cada pedido leva a chave; o servidor confirma-a com a API da Atendia e lê só o que essa chave pode ler.
Criar uma chave
- Abre a consola da Atendia.
- Vai a Definições → Chaves API.
- Escolhe «Nova chave API», dá-lhe um nome e escolhe o tipo: «Só leitura» ou «Leitura e chamadas». Só quem é Proprietário ou Administrador pode criar chaves.
- Copia a chave: só a vês uma vez. Guarda-a num sítio seguro, como o teu gestor de palavras-passe.
Os dois tipos de chave
- «Só leitura»: consulta agentes, chamadas, campanhas, números, ferramentas, base de conhecimento e widgets. Chega para o MCP.
- «Leitura e chamadas»: lê o mesmo e, pela API, também pede e cancela chamadas de saída. Pelo MCP, faz o mesmo que a «Só leitura»: o MCP não faz chamadas.
Para o MCP, usa uma chave «Só leitura». Mesmo assim, quem tiver a chave lê os dados da tua organização, incluindo as transcrições das chamadas. Guarda-a como uma palavra-passe e revoga-a se a perderes.
Como enviar a chave
Envia a chave em todos os pedidos MCP, no cabeçalho x-api-key. O servidor também aceita Authorization: Bearer <chave>.
Trocar de chave
- Cria uma chave nova em Definições → Chaves API. Para o MCP, basta «Só leitura».
- Põe a chave nova na configuração do teu assistente de IA.
- Liga o assistente de IA outra vez e confirma que vês os recursos da Atendia. Uma sessão aberta com a chave antiga não responde à nova: o assistente abre uma sessão nova.
- Revoga a chave antiga em Definições → Chaves API. A partir daí, deixa de funcionar.