For the complete documentation index, see llms.txt. This page is also available as Markdown.

Registros de execução

Solucione problemas de ações, integrações, eventos de analytics e falhas de STT de voz.

Logs de execução

Os logs de execução ajudam você a monitorar e diagnosticar ações, integrações, eventos de analytics e falhas de conversão de fala em texto de voz disparadas pelo seu bot.

Use esta página para inspecionar falhas, revisar entradas e saídas e verificar se os eventos esperados ou as transcrições de voz foram tratados corretamente.

Esta página é diferente de ConfiguraçõesLogs de auditoria e dos logs de execução do portal ou do aplicativo do desenvolvedor.

Abrir logs de execução

Ir para HistóricoLogs de execução.

A página contém quatro abas:

  • Ações de código e API

  • Integrações

  • Eventos de rastreamento

  • Voz

Ações de código e API

Esta aba mostra execuções falhas de Ação de API e de ações de código.

Use-a para depurar chamadas de API personalizadas e ações de código que não foram concluídas com sucesso.

Lembre-se:

  • Esta aba mostra erros, não todas as execuções bem-sucedidas.

  • Você pode inspecionar o código de status, a URL da solicitação, a mensagem de erro, o carimbo de data e hora, o diálogo do bot relacionado, a versão do bot, os detalhes da solicitação e os detalhes da resposta.

  • Uma linha abre um painel de detalhes do erro.

  • As ações de código podem aparecer com uma URL interna do Chatlayer, como chatlayer://code-actions.

  • A exportação CSV está disponível para logs de erro da API.

Colunas

  • Carimbo de data e hora

  • Solicitação, incluindo o método HTTP e a URL

  • Código de status

  • Mensagem de erro

  • Diálogo do bot

  • Versão, como Rascunho ou Ao vivo

Filtros

  • Intervalo de datas

  • Intervalo de códigos de status, como 2xx, 3xx, 4xx, ou 5xx

  • Método HTTP, como GET, POST, PUT, PATCH, ou DELETE

Esta aba oferece suporte à exportação CSV para logs de erro da API.

A retenção segue a configuração de retenção do histórico de erros do bot.

Integrações

Esta aba mostra execuções de Integração de app ações disparadas por diálogos do bot.

Ao contrário de Ações de código e API, esta aba pode mostrar execuções bem-sucedidas e com falha.

Use esta aba para verificar se uma Integração de app ação foi executada com sucesso.

Você pode ver qual ação foi executada, qual diálogo do bot a disparou, qual conta foi usada e quando isso aconteceu.

Você pode abrir uma linha para inspecionar a entrada e a saída da ação.

Execuções com falha mostram detalhes do erro no painel de saída.

Colunas

  • Carimbo de data e hora

  • Status, como sucesso ou falha

  • Diálogo do bot

  • Ação

  • Conta

Filtros

  • Ação ou busca por app/ação

  • Intervalo de datas

  • Status: falha, sucesso, ou qualquer status

Painel de detalhes

Abra uma linha para visualizar o painel de detalhes.

O painel mostra o nome e o status da ação de integração.

Ele vincula de volta ao diálogo do bot relacionado quando disponível.

Ele tem Entrada e Saída abas.

  • Entrada mostra o payload JSON enviado para a integração.

  • Saída mostra os dados retornados para execuções bem-sucedidas ou o objeto de erro para execuções com falha.

Os logs nesta aba são limitados à versão atual do bot, como Rascunho ou Ao vivo.

Eventos de rastreamento

Esta aba mostra eventos analíticos personalizados disparados por blocos de Rastrear evento .

Use esta aba para verificar se um blocos de Rastrear evento bloco foi acionado.

Os atributos do evento ficam visíveis no payload do evento.

Isso ajuda você a diagnosticar a instrumentação de analytics e a falta de dados de eventos.

Colunas

  • Carimbo de data e hora

  • Nome do evento

  • ID da conversa

  • Tipo de canal

Filtros

  • Intervalo de datas

  • Nome do evento

  • Propriedades do evento, como ID da conversa, tipo de canal, ID do canal, ID da campanha e idioma

Você pode expandir uma linha de evento de rastreamento para inspecionar o payload completo do evento, incluindo atributos personalizados.

Voz

Esta aba mostra falhas de fala para texto de chamadas de voz.

Use-a para diagnosticar casos em que o Chatlayer não conseguiu inicializar, conectar, transmitir ou receber a transcrição do provedor de STT configurado.

Lembre-se:

  • A Voz aba mostra erros de STT, não transcrições completas da chamada nem gravações.

  • Cada linha representa uma falha de STT durante uma chamada de voz.

  • Você pode clicar em uma linha para abrir Detalhes do erro de voz.

  • O estado vazio explica que as falhas de STT durante chamadas de voz aparecerão aqui.

  • A paginação mostra 50 erros de STT por página.

A retenção segue a mesma configuração de retenção do histórico de erros do bot.

Colunas

  • Carimbo de data e hora

  • Provedor

  • Modo

  • Código de erro

  • Conversa

  • Mensagem

  • Versão

Filtros

  • Intervalo de datas

  • Provedor: Microsoft ou Google

  • Modo: Sincrono ou Assíncrono

  • Código de erro

Códigos de erro

  • TRANSCRIBE_FAILED — a fala não pôde ser convertida em texto durante a chamada.

  • INIT_FAILED — o mecanismo de STT não pôde ser inicializado.

  • MAX_RETRIES_REACHED — o provedor permaneceu indisponível após as tentativas de repetição.

  • PROVIDER_CONNECT_FAILED — o Chatlayer não conseguiu se conectar ao provedor de STT.

  • STREAM_FAILED — o fluxo de áudio ao vivo para o provedor falhou ou foi interrompido.

Detalhes do erro de voz

Abra uma linha para inspecionar o painel de detalhes do erro de voz.

O painel pode incluir:

  • Código de erro

  • Provedor

  • Modelo, quando disponível

  • Modo

  • Versão

  • ID do canal

  • ID da conversa

  • Carimbo de data e hora

  • Mensagem de erro

  • Payload de detalhes, quando disponível

Use o ID da conversa para encontrar o contexto relacionado em Conversas.

Exemplos de solução de problemas

  • Se um Ação de API falhar, abra Ações de código e API e inspecione a URL da solicitação, o código de status, o corpo da resposta e o diálogo do bot relacionado.

  • Se um Integração de app se comportar de forma inesperada, abra Integrações, filtre por ação e compare os Entrada e Saída payloads.

  • Se os dados de analytics estiverem ausentes, abra Eventos de rastreamento e verifique se o evento esperado foi disparado com os atributos corretos.

  • Se uma chamada de voz tiver problemas de transcrição, abra Voz, filtre por provedor ou código de erro e, em seguida, inspecione os detalhes do erro e os relacionados ID da conversa.

Páginas relacionadas

Atualizado

Isto foi útil?