Pessoa e empresa
Quem sou eu. A pessoa dona do token, o papel dela (admin, líder de vendas ou vendedor), a empresa, o token (escopos e validade) e os limites de chamadas. Use para saber o que esta conexão enxerga.
| Operação | me.get — a mesma de GET /v1/me |
| Escopo | nenhum (qualquer token) |
| Papéis | admin, líder de vendas, vendedor |
| Classe de limite | read |
| Auditada | não |
| Comportamento | somente leitura · idempotente |
Entrada
Nenhum argumento.
Resultado
O JSON da resposta de sucesso de GET /v1/me, com os mesmos campos.
company_get
Seção intitulada “company_get”Dados da empresa. Nome, fuso horário (IANA), modo de venda declarado e período do valor declarado dos negócios. “Hoje” e “este mês” de todas as ferramentas são calculados no fuso da empresa.
| Operação | company.get — a mesma de GET /v1/company |
| Escopo | context:read |
| Papéis | admin, líder de vendas, vendedor |
| Classe de limite | read |
| Auditada | não |
| Comportamento | somente leitura · idempotente |
Entrada
Nenhum argumento.
Resultado
O JSON da resposta de sucesso de GET /v1/company, com os mesmos campos.
company_context
Seção intitulada “company_context”Contexto da empresa. O contexto da empresa em Markdown, no mesmo formato que o Nexo entrega aos próprios modelos: o que a empresa vende, ICP, persona, proposta de valor, posicionamento, oferta e provas. Blocos ainda não confirmados vêm marcados como rascunho. Leia antes de analisar negócios ou conversas.
| Operação | company.context.pack — a mesma de GET /v1/company/context/pack |
| Escopo | context:read |
| Papéis | admin, líder de vendas, vendedor |
| Classe de limite | read |
| Auditada | não |
| Comportamento | somente leitura · idempotente |
Entrada
Nenhum argumento.
Resultado
O JSON da resposta de sucesso de GET /v1/company/context/pack, com os mesmos campos.
methodology
Seção intitulada “methodology”Metodologia Winning. A metodologia Winning: a física da compra (o que a situação do negócio pede), as fases e, quando falta histórico da empresa, a conversão de referência da metodologia, descoberta e qualificação, os sinais de que um negócio anda ou parou, e a taxonomia de objeções e dores. Consulte antes de responder pergunta de como vender, como abordar, como responder a uma objeção ou o que fazer num negócio. É a mesma consulta que o copiloto do Nexo faz, na visibilidade da pessoa; não roda IA.
| Operação | methodology.topics — consulta do copiloto, sem rota /v1 |
| Escopo | context:read |
| Papéis | admin, líder de vendas, vendedor |
| Classe de limite | read |
| Auditada | não |
| Comportamento | somente leitura · idempotente |
Entrada
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
tema |
"fisica_da_compra" | "fases_e_conversao" | "descoberta_e_qualificacao" | "sinais_do_negocio" | "objecoes_e_dores" |
não | Tema da metodologia, quando você já sabe qual quer |
pergunta |
string | não | A pergunta de venda em português, para o Nexo escolher os temas (máx. 300 caracteres) |
Resultado
Um JSON compacto em português, o mesmo que o copiloto do Nexo recebe para esta consulta. Não há rota /v1 equivalente.
integration_health
Seção intitulada “integration_health”Saúde das integrações. Os problemas abertos das integrações da empresa (agenda, gravação nativa do Meet ou do Teams, Assistente Nexo e WhatsApp), cada um com o que aconteceu, o impacto, os passos de solução, o botão de Minha empresa e um roteiro com o que mais conferir. Com problema, devolve só o roteiro daquele código, mesmo sem ele estar aberto. É a mesma consulta que o copiloto do Nexo faz, na visibilidade da pessoa; não roda IA.
| Operação | integrations.health — consulta do copiloto, sem rota /v1 |
| Escopo | context:read |
| Papéis | admin, líder de vendas |
| Classe de limite | read |
| Auditada | não |
| Comportamento | somente leitura · idempotente |
Entrada
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
problema |
"connection_invalid" | "native_access_refused" | "native_not_recording" | "meet_scopes_missing" | "native_no_connection" | "native_no_host" | "bot_not_admitted" | "bot_failing" | "token_invalid" | "number_disconnected" | "history_window_expired" | "media_access_refused" | "audio_transcription_failing" |
não | Código do problema, quando a pergunta é sobre um só (ex.: meet_scopes_missing); sem ele, vêm todos os abertos |
Resultado
Um JSON compacto em português, o mesmo que o copiloto do Nexo recebe para esta consulta. Não há rota /v1 equivalente.