> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/history/execution-logs.md). # Registros de execução ## 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ções** → **Logs de auditoria** e dos logs de execução do portal ou do aplicativo do desenvolvedor. ### Abrir logs de execução Ir para **Histórico** → **Logs de execução**. A página contém quatro abas: * **Ações de código e API** * **Integrações** * **Eventos de rastreamento** * **Voz** ![](/files/de2fc78dedbc65750e5c8c282626d2ba8e24e334) ### 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. {% hint style="info" %} A retenção segue a configuração de retenção do histórico de erros do bot. {% endhint %} ### 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. {% hint style="info" %} A retenção segue a mesma configuração de retenção do histórico de erros do bot. {% endhint %} #### 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](/chatlayer-documentation-pt-br/navegacao/history/user-messages.md). ### 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 * [Recursos avançados da API](/chatlayer-documentation-pt-br/integrateandcode/custom-back-end-integrations/advanced-api-integrations.md) * [Integrações de app](/chatlayer-documentation-pt-br/integrateandcode/app-integrations.md) * [Rastrear eventos para analytics](/chatlayer-documentation-pt-br/bot-answers/track-events-for-analytics.md) * [Conversão de fala em texto do voicebot](/chatlayer-documentation-pt-br/voz/phone-and-voice/voicebot-speech-to-text-fine-tuning.md) * [Conversas](/chatlayer-documentation-pt-br/navegacao/history/user-messages.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/history/execution-logs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.