Referência completa dos endpoints REST públicos disponíveis para integrações externas via API Key.

Endpoints da API

Estes são os endpoints REST públicos disponíveis para integrações externas via autenticação por API Key.

Todas as requisições devem incluir o header X-API-Key com uma API Key válida.

GET /api/salespersons

Lista os vendedores e supervisores da empresa autenticada.

Fluxo de Uso

Chame GET /api/salespersons para obter a lista de vendedores da sua empresa.
Localize o vendedor desejado e copie o id dele.
Use esse id no campo salespersonId ao fazer uma requisição POST /api/analyses. Isso garante que a análise seja gerada conforme a função de trabalho específica do vendedor.

Headers

Header	Obrigatório	Descrição
`X-API-Key`	Sim	Sua API Key

Resposta

[
  {
    "id": "user_xxx",
    "name": "João Silva",
    "role": "salesperson",
    "jobFunctionName": "SDR",
    "supervisorName": "Maria Souza"
  },
  {
    "id": "user_yyy",
    "name": "Maria Souza",
    "role": "supervisor",
    "jobFunctionName": "Sales Manager",
    "supervisorName": null
  }
]

Campos da Resposta

Campo	Tipo	Descrição
`id`	`string`	ID único do usuário (use em `POST /api/analyses`)
`name`	`string`	Nome completo
`role`	`string`	`"salesperson"` ou `"supervisor"`
`jobFunctionName`	`string \| null`	Nome da função de trabalho atribuída
`supervisorName`	`string \| null`	Nome do supervisor atribuído

POST /api/analyses

Cria uma nova análise de vendas com IA. Requer transcript ou audioKey.

Headers

Header	Obrigatório	Descrição
`X-API-Key`	Sim	Sua API Key
`Content-Type`	Sim	`application/json`

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
`transcript`	`string`	Um de `transcript` ou `audioKey`	Transcrição completa da ligação de vendas
`audioKey`	`string`	Um de `transcript` ou `audioKey`	Fonte de áudio (veja Opções de Entrada de Áudio abaixo)
`salespersonId`	`string`	Não	ID do vendedor (obtido via `GET /api/salespersons`)
`salespersonName`	`string`	Não	Nome do vendedor
`clientName`	`string`	Não	Nome do cliente

Opções de Entrada de Áudio

Você pode fornecer áudio via o campo audioKey de três formas:

URL direta: URL HTTP/HTTPS de um arquivo de áudio (ex: "https://exemplo.com/audio.mp3")
Base64: Data URL com áudio codificado em base64 (ex: "data:audio/mp3;base64,SGVsbG8g...")

Formatos suportados: mp3, mp4, wav, ogg, opus

Exemplo de Requisição (com transcript)

{
  "salespersonId": "user_1234567890",
  "clientName": "Cliente Teste",
  "transcript": "Olá, meu nome é João da evoluAI..."
}

Exemplo de Requisição (com URL de áudio)

{
  "salespersonId": "user_1234567890",
  "clientName": "Cliente Teste",
  "audioKey": "https://exemplo.com/audio.mp3"
}

Resposta

{
  "id": "anal_xxx",
  "score": 87,
  "summary": "O vendedor demonstrou forte rapport...",
  "clientName": "Cliente Teste",
  "salespersonName": "João Silva",
  "audioDurationSeconds": 420,
  "dimensionScores": {
    "rapport": 90,
    "listening": 85,
    "objections": 80,
    "clarity": 88,
    "closing": 75
  },
  "jobFunctionAnalysis": {
    "microObjectives": [
      {
        "criteria": "string",
        "met": true,
        "timestamp": "string",
        "evidence": "string"
      }
    ],
    "negativeIndicators": [
      {
        "criteria": "string",
        "present": false,
        "timestamp": "string",
        "evidence": "string"
      }
    ]
  },
  "jobFunctionScore": 82,
  "objections": [{"objection": "Preocupação com preço", "resolved": true}],
  "strengths": ["Abertura forte", "Escuta ativa"],
  "improvements": ["Fechar com mais assertividade"],
  "phaseSuggestions": {
    "opening": "string",
    "discovery": "string",
    "problem": "string",
    "solution": "string",
    "objections": "string",
    "next_steps": "string"
  },
  "productExploration": {
    "explored": true,
    "products": ["Produto A"]
  },
  "profile": "Consultivo",
  "stage": "Qualify",
  "bant": {
    "budget": "string",
    "authority": "string",
    "need": "string",
    "timing": "string"
  },
  "publicLink": "https://app.evoluai.com.br/analysis/anal_xxx",
  "createdAt": "2024-01-15T12:00:00.000Z"
}

Respostas de Erro

Status	Código	Descrição
400	`BAD_REQUEST`	`transcript` e `audioKey` ausentes
401	`UNAUTHORIZED`	API Key inválida ou ausente
403	`FORBIDDEN`	Minutos/créditos insuficientes
404	`NOT_FOUND`	Vendedor não encontrado
429	`TOO_MANY_REQUESTS`	Rate limit atingido

Endpoints

On this page