VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Referência completa/WhatsApp: conhecimento do assistente

Registro de chamadas à IA

Lista as chamadas que o assistente de WhatsApp fez a provedores de IA, com custo, duração e resultado.

Cada vez que o assistente de WhatsApp chama um provedor de IA (para conversar, transcrever áudio, falar ou entender uma imagem) a plataforma registra a chamada. Esta rota lista os registros, para auditar custo, lentidão e erros.

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

Lista as chamadas à IA do assistente de WhatsApp

Parâmetros de consulta

vendor_iduuid
Filtra por seller.
kindstring
chatttswhispervision
Filtra pelo tipo de chamada.
statusstring
successrate_limitederror
Filtra pelo resultado.
fromstring
Início do período, em RFC 3339 ou AAAA-MM-DD (meia-noite UTC). Valor inválido é ignorado em silêncio.
tostring
Fim do período, no mesmo formato.
limitintegerpadrão: 50
Itens por página. Valores menores que 1 ou maiores que 200 voltam para 50 (a resposta ecoa o valor enviado).
offsetintegerpadrão: 0
Quantos itens pular.

Exemplo de requisição (Listar chamadas)

Resposta (Listar chamadas)

200Registros devolvidos

Campos da resposta

logsarray

Registros da página, do mais novo ao mais antigo.

iduuid
Identificador do registro.
vendor_iduuid
Seller da conversa. Ausente quando não há.
vendor_namestring
Nome do seller. Ausente quando não há.
thread_iduuid
Conversa em que a chamada ocorreu. Ausente quando não há.
kindstring
chatttswhispervision
Tipo da chamada à IA.
providerstring
Provedor de IA usado.
modelstring
Modelo usado.
prompt_tokensinteger
Tokens enviados.
completion_tokensinteger
Tokens recebidos.
cost_centavosinteger
Custo estimado em centavos de real. Ausente quando o preço do modelo não foi declarado.
duration_msinteger
Duração da chamada, em milissegundos.
statusstring
successrate_limitederror
Resultado.
error_messagestring
Mensagem de erro do provedor. Ausente em sucesso.
request_jsonobject
O que foi enviado ao provedor. Pode conter trechos de conversa de clientes.
response_jsonobject
O que o provedor devolveu.
created_atstring
Quando a chamada ocorreu (RFC 3339, UTC).
totalinteger
Total que casa com os filtros.
limitinteger
Limite pedido.
offsetinteger
Deslocamento pedido.

Erros (Listar chamadas)

StatusQuandoCorpo
401Sem token, token inválido ou expirado.{"error":"missing authorization header"}
403O módulo WhatsApp Commerce está desligado na loja, o usuário não é administrador ou não tem o privilégio exigido.{"error":"module_disabled","module":"whatsapp-commerce"} ou {"error":"insufficient privileges","required":"manage_settings"} ou {"error":"admin access required"}
500Falha ao consultar.{"error":"Failed to list AI logs: ..."}
Dado sensível

request_json e response_json guardam o conteúdo trocado com o provedor, que pode incluir o que clientes escreveram. Não repasse essas listas a terceiros e peça só o intervalo de que precisa.

Custo ausente não é custo zero

Quando cost_centavos não aparece, a plataforma não conhece o preço daquele modelo. Some só os registros que têm o campo e trate o resto como desconhecido.

Veja também

  • Visão geral
  • Entradas da base
Anterior
Correções de marca
Próxima
WhatsApp: moderação de mídia
Nesta página
  • Exemplo de requisição (Listar chamadas)
  • Resposta (Listar chamadas)
  • Erros (Listar chamadas)
  • Veja também
bash
curl "$BASE_URL/api/v1/admin/whatsapp/ai-logs?kind=chat&status=error&limit=20" \
  -H "Authorization: Bearer $TOKEN"
json
{
  "logs": [
    {
      "id": "91a1be42-5af0-4120-b920-dfb8e62b1ffa",
      "vendor_id": "9d9d9d56-eb43-4719-889d-055632f7c7da",
      "vendor_name": "Loja Exemplo",
      "kind": "chat",
      "provider": "openai",
      "model": "example-model",
      "prompt_tokens": 522,
      "completion_tokens": 66,
      "cost_centavos": 0,
      "duration_ms": 540,
      "status": "success",
      "request_json": {
        "model": "example-model",
        "messages": [
          "..."
        ]
      },
      "response_json": {
        "id": "resp-7f3a9c21d4e85b60",
        "usage": {
          "prompt_tokens": 525,
          "completion_tokens": 69
        }
      },
      "created_at": "2026-10-11T21:50:09.113Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}