> Como autenticar na API do conecta/ai com chave de API, quais permissões uma chave pode ter e como guardar a chave com segurança. # Autenticação e permissões Toda requisição leva uma chave de API no cabeçalho `Authorization`: ```http Authorization: Bearer ck_ ``` A chave é criada em **Configurações › Integrações › Chaves de API** e tem o formato `ck__`. O conecta/ai guarda só um resumo dela, por isso ela é mostrada uma única vez. Perdeu? Revogue e crie outra. ## A organização vem da chave A chave pertence a uma organização, e a API só enxerga essa organização. Nenhum parâmetro escolhe outra. Um identificador de outra organização responde `404`, como se não existisse. ## Permissões Cada endpoint exige uma permissão, marcada na chave quando ela é criada. Sem ela, a resposta é `403` com `code: "insufficient_scope"`, e a frase diz qual permissão faltou. A permissão de cada endpoint está na [referência](/referencia). Conceda só o que a integração usa. Uma chave para o BI precisa apenas de leitura. ## O que a API nunca devolve - Conversa de contato de teste: é ensaio da equipe, não atendimento. - Nota interna da equipe. - Texto de mensagem apagada (vem `deleted: true` e `text: null`). - Link para arquivo de mídia: a mensagem descreve o anexo (tipo, formato e nome). - Etiqueta pessoal de atendente. ## Guarde a chave no servidor > **Atenção.** > A chave dá acesso aos dados que as permissões dela liberam, inclusive telefone e mensagens dos seus clientes. Use-a só no servidor. Nunca a coloque em página web, aplicativo instalado no celular do cliente ou repositório de código. A chave revogada ou vencida para de funcionar na hora e responde `401` com `code: "invalid_credential"`. Sem o cabeçalho, a resposta é `401` com `code: "unauthenticated"`.