API atual/Referência completa/WhatsApp: assistente de IA

GETRegistro de chamadas

Lista as chamadas ao modelo de IA com tokens, tempo, resposta resumida e erro, para auditoria e custo.

Devolve as chamadas mais recentes primeiro. Use para descobrir por que o assistente respondeu algo, achar chamadas com erro ou somar tokens.

GET/api/v1/admin/whatsapp-confluence/ai/logsAdmin

Lista o registro de chamadas de IA

Parâmetros de consulta

qstring

Busca por trecho no modelo, na resposta, no erro, nos nomes de ferramentas ou no telefone (só dígitos).

kindstring

Tipo da chamada, valor exato. Valores vistos: bot (WhatsApp), web_chat (chat da mini-loja), playground (teste).

errorsboolean

1 ou true mostra só chamadas que falharam.

pageintegerpadrão: 1

Página, a partir de 1.

per_pageintegerpadrão: 50

Itens por página, de 1 a 200 (fora disso, 50).

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/whatsapp-confluence/ai/logs?errors=true&per_page=20" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Chamadas

json

{
  "logs": [
    {
      "id": 3,
      "thread_id": "e661b36c-fe1b-450f-b75b-49d10c1ead48",
      "phone": "•••••••••4321",
      "kind": "bot",
      "model": "example-model",
      "prompt_tokens": 3120,
      "completion_tokens": 85,
      "latency_ms": 2140,
      "tool_calls": [
        "search_products",
        "add_to_cart"
      ],
      "reply_preview": "Adicionei a camiseta azul ao seu carrinho. Quer ver o frete?",
      "created_at": "2026-10-10T18:42:12Z"
    }
  ],
  "page": 1,
  "per_page": 20,
  "total": 1
}

Campos da resposta

logsarray

Chamadas da página.

logs[].idinteger

Id crescente.

logs[].thread_iduuid

Conversa, quando houver.

logs[].phonestring

Telefone mascarado (últimos 4 dígitos). Ausente se não houver conversa.

logs[].kindstring

Tipo da chamada.

logs[].modelstring

Modelo usado.

logs[].prompt_tokensinteger

Tokens enviados.

logs[].completion_tokensinteger

Tokens gerados.

logs[].latency_msinteger

Duração em milissegundos.

logs[].tool_callsarray

Nomes (internos) das ferramentas e etapas usadas no turno. Trate como opaco.

logs[].reply_previewstring

Início da resposta (cerca de 240 caracteres).

logs[].errorstring

Erro da chamada. Ausente quando deu certo.

logs[].created_atstring

Quando ocorreu (RFC 3339).

pageinteger

Página devolvida.

per_pageinteger

Tamanho da página usado (ecoa o valor pedido).

totalinteger

Total que combina com o filtro, todas as páginas.

Erros

Status	Quando	Corpo de exemplo
500	Falha ao consultar.	`{"error":"..."}`
401	Sem token, token inválido ou expirado.	`{"error":"missing authorization header"}`
403	O usuário não tem papel de administrador.	`{"error":"insufficient permissions"}`