ChatSense
Integrações api key token autenticação escopos

API Keys: gerar, escopos e revogar

API Keys

Gerar

  1. Admin → Integrações → API Keys → Nova Key
  2. Nome descritivo + seleção de escopos
  3. A key é exibida apenas uma vez — copie imediatamente

Escopos disponíveis

EscopoPermissão
conversations:readLer conversas
conversations:writeCriar e responder conversas
contacts:readLer contatos
contacts:writeCriar e editar contatos
campaigns:writeCriar campanhas

Escopo por conta

Se você usa múltiplas contas por canal, cada key pode ser restrita a contas específicas: ao criar a key, selecione as contas permitidas em Contas com acesso. Uma key escopada só enxerga conversas, contatos e campanhas das contas selecionadas — ideal para integrações de parceiros ou por unidade de negócio. Keys sem restrição de conta acessam a organização inteira (respeitando os escopos acima).

Usar na API

Authorization: Bearer sua_api_key_aqui

Revogar

Admin → Integrações → API Keys → [key] → Revogar — efeito imediato.

⚠️ Nunca comite API Keys em repositórios públicos. Use variáveis de ambiente.