Comece por aqui

Autenticação e permissões

Uma chave por integração. Acesso explícito a cada agente e operação.

API v1•REST · JSON · Bearer token

Autenticar solicitações

Envie a chave no header abaixo em todas as chamadas. Cookies da plataforma e chaves na URL não são aceitos. Solicitações de navegadores com header Origin são rejeitadas.

Authorization: Bearer rit_live_SUA_CHAVE

Permissões

A chave precisa incluir a permissão do endpoint e o agente precisa estar na lista permitida. Recursos de outras contas ou de agentes fora da lista retornam 404.

Permissão	Operações
`agents:read`	Listar agentes, Consultar agente
`messages:write`	Enviar mensagem
`agents:control`	Desligar IA para um contato
`kanban:read`	Consultar colunas, Listar contatos
`kanban:write`	Mover contato
`knowledge:write`	Enviar arquivo
`knowledge:read`	Consultar processamento

Validade e revogação

Novas chaves têm validade de até 365 dias e acesso explícito aos agentes escolhidos. Revogue uma chave em Configurações para bloquear novas chamadas. Uma solicitação já iniciada pode terminar.

Na rotação, crie uma nova chave, atualize o servidor da integração, confirme o funcionamento e revogue a antiga. Chaves legadas mantêm somente consulta de agentes e envio de mensagens; substitua-as para escolher agentes, validade e novas permissões.