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)

bash

curl "$BASE_URL/api/v1/admin/whatsapp/ai-logs?kind=chat&status=error&limit=20" \
  -H "Authorization: Bearer $TOKEN"

Resposta (Listar chamadas)

200Registros devolvidos

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
}

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)

Status	Quando	Corpo
401	Sem token, token inválido ou expirado.	`{"error":"missing authorization header"}`
403	O 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"}`
500	Falha ao consultar.	`{"error":"Failed to list AI logs: ..."}`

Veja também

Registro de chamadas à IA

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

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)

bash

curl "$BASE_URL/api/v1/admin/whatsapp/ai-logs?kind=chat&status=error&limit=20" \
  -H "Authorization: Bearer $TOKEN"

Resposta (Listar chamadas)

200Registros devolvidos

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
}

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)

Status	Quando	Corpo
401	Sem token, token inválido ou expirado.	`{"error":"missing authorization header"}`
403	O 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"}`
500	Falha ao consultar.	`{"error":"Failed to list AI logs: ..."}`