Páginas do MCP

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

  1. Abre a consola da Atendia.
  2. Vai a Definições → Chaves API.
  3. 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.
  4. 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

  1. Cria uma chave nova em Definições → Chaves API. Para o MCP, basta «Só leitura».
  2. Põe a chave nova na configuração do teu assistente de IA.
  3. 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.
  4. Revoga a chave antiga em Definições → Chaves API. A partir daí, deixa de funcionar.