> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logs de mensagens

> Inspecione o status de entrega de mensagens individuais enviadas e recebidas do WhatsApp.

A página **Message Logs** fornece um registro de mensagens individuais do WhatsApp processadas pela YCloud. Todas as mensagens enviadas com sucesso para a plataforma YCloud são exibidas aqui.

Se a sua empresa enviar uma mensagem, mas o destinatário não a receber, use os Logs de mensagens para verificar o status atual da mensagem e investigar o motivo específico da falha.

Para abrir a página, acesse **Analytics > Message logs**.

<img src="https://mintcdn.com/lchnan/7AejdQWTE_GcFoQy/images/image-20.png?fit=max&auto=format&n=7AejdQWTE_GcFoQy&q=85&s=0833995632ba87f21cd552e90d996a79" alt="Imagem" width="2914" height="1580" data-path="images/image-20.png" />

## Pesquisar e filtrar mensagens

Por padrão, os Logs de mensagens exibem mensagens **enviadas (outbound)** . Para visualizar as mensagens recebidas de clientes, abra o filtro **Direction** e selecione **Inbound**.

Os filtros disponíveis incluem:

* Informações de contato ou nome do modelo
* Horário de envio
* Horário de entrega
* País
* Direção
* Número do WhatsApp Business
* Status
* Tipo de mensagem

Combine filtros para localizar uma mensagem específica ou investigar um grupo de mensagens relacionadas.

<Frame caption="Open Direction and select Inbound to inspect received messages. This view has no matching records.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-2026-09-23/message-direction-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=1c137fa50f7279fb7884941b9b655c9f" alt="Filtro Direction dos logs de mensagens exibindo as opções Outbound e Inbound." width="3024" height="1656" data-path="product-assets/english-help-2026-09-23/message-direction-annotated.svg" />
</Frame>

Este exemplo mostra uma pesquisa sem mensagens correspondentes.

## Entenda os campos do log

Cada registro pode incluir:

| Campo | Descrição |
| - | - |
| **Time Sent** | Quando a mensagem foi enviada ou recebida pela YCloud. |
| **Time Delivered** | Quando o WhatsApp informou que a mensagem foi entregue. |
| **Time Read** | Quando o WhatsApp informou que o destinatário leu a mensagem. |
| **Country** | O país ou região do cliente. |
| **Direction** | **Outbound** para mensagens enviadas pela empresa ou **Inbound** para mensagens recebidas de clientes. |
| **Contact** | O cliente associado à mensagem. |
| **WhatsApp Business Number** | O número de telefone comercial que enviou ou recebeu a mensagem. |
| **Message** | Uma prévia da mensagem ou o nome do modelo. |
| **Status** | O status mais recente conhecido da mensagem, como Sent, Delivered, Read ou Failed. |

Para mensagens que falharam, abra o registro ou visualize os detalhes da falha para identificar o motivo antes de tentar novamente.

<Note>
  Se uma mensagem enviada não aparecer nos Logs de mensagens, confirme se a solicitação original foi aceita com sucesso pela YCloud.
</Note>

## Exportar logs de mensagens

Clique em **Export** para baixar os registros de mensagens filtrados. Durante a exportação, você pode selecionar o fuso horário usado para os registros de data e hora exportados.

A exportação é controlada por permissões:

* Os administradores da conta podem exportar logs.
* Outros membros devem receber a permissão de exportação apropriada.
* A pessoa que realiza a exportação deve concluir a autenticação de dois fatores (2FA).

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Por que o status da mensagem é Failed?">
    As mensagens podem falhar por diferentes motivos. Veja os detalhes da falha no registro para conferir o erro específico e, em seguida, resolva o problema relatado antes de enviar a mensagem novamente.
  </Accordion>

  <Accordion title="Por que o horário de leitura está vazio?">
    O horário de leitura aparece apenas após o WhatsApp relatar uma confirmação de leitura. Se o destinatário tiver desativado as confirmações de leitura, a YCloud poderá não receber o status de leitura.
  </Accordion>

  <Accordion title="Por que o campo Mensagem exibe [Button] ou [Unsupported message] em vez do conteúdo completo?">
    O WhatsApp oferece suporte a diversos formatos de mensagens interativas e de mídia avançada, e alguns não podem ser totalmente renderizados na tabela de logs. Copie o número de telefone do cliente e pesquise a conversa no Inbox para visualizar o conteúdo do chat.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.