Quando usar
- Você está configurando uma integração e precisa do
api_access_tokenpara autenticar as requisições - Você quer reutilizar a mesma chave em outro fluxo (HubSpot, Postman, script)
- Você precisa rotacionar a chave por segurança
Pré-requisitos
- Estar logado no Cloud Chat com a sua conta — a chave é gerada por usuário, não por conta
Sobre este artigo
A chave de API ficava no fim da tela de Configurações do Perfil, junto com foto, assinatura e notificações. Agora ela tem uma página própria, MCP / API, no mesmo menu do seu avatar. É lá que ficam os dois assuntos de integração do seu usuário: o Servidor MCP, para ligar a Cloud Humans a assistentes de IA, e a Chave de API, para autenticar chamadas à API do Cloud Chat.
Se você abrir o menu e ainda não vir MCP / API, mas encontrar Token de acesso no fim das Configurações do Perfil, a sua instância ainda não recebeu essa atualização. O valor da chave é exatamente o mesmo nos dois lugares — copie de onde ela estiver.
Passo a passo
Etapa 1 — Abrir a página MCP / API
-
No canto inferior esquerdo, clique no seu avatar para abrir o menu
-
Clique em MCP / API
Etapa 2 — Copiar a chave
-
Vá até a seção Chave de API, a segunda da página
-
A chave aparece mascarada. Clique no ícone de olho para revelá-la, ou use direto o botão de copiar para levar o valor para a área de transferência
Use esse valor no header api_access_token das suas requisições à API do Cloud Chat.
Etapa 3 — Gerar uma chave nova (opcional)
Faça isso só quando precisar rotacionar a chave — por exemplo, se desconfiar de vazamento.
-
Na seção Chave de API, clique no botão de setas circulares, à esquerda do botão de copiar
-
Confirme na janela que abrir
A chave antiga é invalidada na hora. Qualquer integração que ainda use o valor anterior para de funcionar até ser atualizada com a chave nova.
Observações
A chave de API é pessoal e por usuário: ela dá acesso aos dados da sua conta, com as suas permissões. Trate como senha — não compartilhe publicamente e não faça commit dela em repositórios.
-
Não encontrou a seção Chave de API? Em contas que usam apenas o painel da ClaudIA, essa seção não aparece — só a do Servidor MCP. Fale com o seu time de atendimento da Cloud Humans.
-
Servidor MCP é outra coisa. Ele fica na mesma página, mas não usa chave nenhuma: a autorização acontece no login da sua própria conta Cloud Humans. O passo a passo está no guia de conexão do MCP.
-
Para usar a chave numa extração de dados em lote: Como extrair dados em lote via API (Data Extract API)