Primeiros passos
Autenticação
Toda chamada leva um token permanente do workspace no header Authorization, no esquema Bearer.
Header
Authorization: Bearer sk_000a0000a00000a0000a00000a0000a00000Criar um token#
- Ajustes › Integrações › Integração via API para seus sistemas, ou Ajustes › Integrações › N8N para o n8n — os dois geram o mesmo tipo de token (
sk_), só muda a origem mostrada na lista. - Somente administradores do workspace criam, renomeiam e excluem tokens.
- O token aparece uma única vez, na criação. Perdeu? Exclua e gere outro.
- A lista mostra quando cada token foi usado pela última vez — útil para achar tokens esquecidos.
Escopo#
O token pertence a um workspace e só enxerga os dados dele: contatos, conversas, modelos, sequências, chatbots e webhooks. Não há permissão por usuário — trate o token como a senha de um administrador.
Revogar#
Excluir o token no painel corta o acesso na hora: a próxima chamada recebe 401. Se o workspace for suspenso ou cancelado, as chamadas recebem 403 com um code (veja Limites e erros).
Guarde o token no servidor
Nunca coloque o token em código que roda no navegador ou num app instalado: qualquer pessoa conseguiria copiá-lo. Use variáveis de ambiente ou um cofre de segredos e chame a API a partir do seu back-end.Testar#
GET /me responde 200 com o workspace quando o token e o endereço base estão certos. Em cada página da referência há o botão Experimente: cole o token no painel da direita e faça chamadas reais.