Núcleo Wondai icon

Núcleo Wondai

Atendimento de IA no Núcleo Wondai: preparar conversa (GATE liga/desliga + contexto operacional ANTES da LLM), buscar cliente, resolver catálogo (fuzzy), criar/alterar/cancelar pedido, consultar contexto e registrar conversa. Assinatura HMAC; o tenant vem do token.

Telemetria → Timeline Sanitizada

AI-generated

Summary

Send a sanitized timeline trace event to the Núcleo Wondai telemetry system to record a technical step of execution identified by trace ID, stage, status, operation, duration, error code, and used tools.

Inputs

  • Token ID Dinamico — Optional dynamic token for multi-tenant bootstrap, used with the dynamic Signing Secret.
  • Signing Secret Dinamico — Optional ephemeral signing secret from bootstrap; should never be stored in logs or outputs.
  • Chave do Evento (required) — Event key for idempotency combining trace_id, stage, and technical sequence.
  • Trace ID (required) — Technical correlation ID; should not contain phone numbers, messages, or domain IDs.
  • Etapa (required) — Stage of the trace event, e.g., 'router_complete'.
  • Status (required) — Status of the trace event; one of 'success', 'error', or 'blocked'.
  • Operação Técnica — Optional technical operation name associated with the trace.
  • Duração (ms) — Optional duration of the stage in milliseconds.
  • Código de Erro Técnico — Optional allowlisted technical error code; raw error messages are not allowed.
  • Ferramentas Técnicas — Optional list of comma-separated technical tools used, only names without arguments or outputs.

Output shape

a single JSON object containing the telemetry trace event response or an error report if failure occurs.

The operation is idempotent by the 'Chave do Evento' parameter, so re-sending with the same key does not duplicate entries. The node signs the request using HMAC with the provided or credential tokens and secrets. If the HTTP status indicates error (>=400), the node throws an error or returns it if 'continueOnFail' is enabled.

Links

Discussion