Pular para o conteúdo

Overview

API pública do Nexo: o contexto compactado, a inteligência e as conversas da sua empresa, com as mesmas permissões do app.

Autenticação. Envie Authorization: Bearer nexo_pat_.... O token é pessoal: age como a pessoa que o criou, com o papel e a visibilidade dela no app (o vendedor vê os próprios negócios e conversas; admin e líder de vendas veem os da empresa). Cada pessoa cria e revoga os próprios tokens no Nexo. Se a pessoa é inativada ou removida, os tokens dela param na hora.

Escopos. context:read (contexto, negócios, indicadores, metas, tarefas), conversations:read (conversas na íntegra) e exports:create (exportações). A permissão efetiva é papel ∩ escopos ∩ plano.

Limites. Cada empresa tem um limite por classe de operação (read, content, …) somando todos os tokens, e cada token um sublimite. Toda resposta traz RateLimit-Policy e RateLimit; um 429 traz Retry-After. Chamadas de dados nunca consomem a franquia de IA.

Erros. application/problem+json com { type, title, status, detail, requestId, meta? }. type é estável e em inglês; detail é em português. Envie o requestId ao suporte.

Versão. /v1 só recebe mudanças aditivas. Uma mudança incompatível vira /v2, com pelo menos 12 meses de convivência.

Information

  • OpenAPI version: 3.0.0

Token pessoal nexo_pat_…

Security scheme type: http

Bearer format: JWT