API atual/Referência completa/Venddor Intelligence: conversas

Auditoria da VI

Lista as execuções registradas da VI na loja, com a intenção, o resultado e quem pediu.

Complementa Confirmar ações: enquanto aquela lista mostra as alterações, esta mostra as execuções de capacidades da VI com sucesso ou falha. É uma rota de consulta para quem acompanha o uso da assistente e exige um privilégio próprio.

Devolve as execuções mais recentes primeiro. O privilégio intelligence_view_audit vem desligado por padrão: conceda-o apenas a quem deve ver o registro.

GET/api/v1/admin/intelligence/auditAdmin

Registro de execuções da VI

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um administrador (veja Tokens).

Parâmetros de consulta

limitinteger

Quantidade máxima. Padrão 50, teto 500.

intentstring

Igualdade exata em intent. Os valores são identificadores internos, sem contrato estável: descubra-os pela própria listagem.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/intelligence/audit?limit=20" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Entradas

json

{
  "entries": [
    {
      "audit_id": "1a585252-eb96-4586-b91f-352248a0af71",
      "user_id": "b86a5263-d9a6-4b7d-bb47-9835023eba56",
      "company_id": "dfe2555e-bfd0-41a8-9fa1-9586999f3798",
      "intent": "exemplo",
      "success": true,
      "created_at": "2026-10-06T09:49:35.980008Z"
    }
  ],
  "total": 1
}

Campos da resposta

entries[].audit_iduuid

Id do registro.

entries[].user_iduuid

Quem pediu.

entries[].company_iduuid

Loja ou vendedor associado. Pode vir vazio.

entries[].intentstring

Identificador da capacidade executada. Valor interno, em português, sem garantia de estabilidade.

entries[].successboolean

Se terminou bem.

entries[].created_atstring

RFC 3339.

totalinteger

Quantidade devolvida.

Erros

Status	Quando	Corpo
401	Sem token ou token inválido/expirado.	`{"error":"missing authorization header"}` ou `{"error":"invalid or expired token"}`
403	O administrador não tem nenhum dos privilégios exigidos.	`{"error":"insufficient privileges","privilege_required_any":["intelligence_view_audit","manage_settings"]}`

Veja também

Confirmar ações