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

# Message Logs and Analytics — Pilot Status Dashboard

> View auditable message history, delivery status, and real-time analytics for all your WhatsApp numbers in the Pilot Status dashboard.

Pilot Status records every message that passes through your numbers and surfaces that data in two dedicated dashboard sections: **Logs** for a complete, searchable audit trail of individual messages, and **Analytics** for real-time aggregate metrics across your entire account.

## Message Logs

Open **Dashboard → Logs** to see the full message history for your project. Every inbound and outbound message appears as a row in the log table, with the following fields:

* **Message ID** — a unique identifier you can use to correlate log entries with webhook events and API responses.
* **Direction** — whether the message was inbound (received by your number) or outbound (sent by your system or Live Chat).
* **Recipient / Sender** — the phone number on the other end of the conversation.
* **Content preview** — the first characters of the message body, or a media-type label for non-text messages.
* **Timestamp** — the exact date and time the message was processed by Pilot Status servers.
* **Status** — the current delivery state of the message (see the table below).

Use the **search bar** and **filter toolbar** at the top of the Logs page to narrow results by number, date range, direction, or status. This makes it straightforward to investigate a delivery issue or retrieve the history for a specific contact.

## Message Status Explained

| Status    | Meaning                                                             |
| --------- | ------------------------------------------------------------------- |
| Sent      | The message left Pilot Status servers and was accepted by WhatsApp. |
| Delivered | The message arrived on the recipient's device.                      |
| Read      | The recipient opened the message in their WhatsApp app.             |
| Failed    | Delivery failed — click the row to view the error code and details. |

## Analytics

Open **Dashboard → Analytics** to view real-time metrics aggregated across all your connected numbers. The Analytics page includes:

* **Total messages sent** and **received** over the selected time window.
* **Delivery rate** — the percentage of sent messages that reached the recipient's device.
* **Read rate** — the percentage of delivered messages that were opened by the recipient.
* **Messages by number** — a breakdown of volume per connected number, useful for spotting which numbers are most active.
* **Timeline chart** — a bar or line chart showing message volume over time. Toggle between **hourly** and **daily** views to zoom in or out on trends.

All metrics update in real time as messages flow through your numbers, so the dashboard always reflects your current state.

## Exporting and Auditing Logs

Every message in Pilot Status carries a **unique message ID** that links the log entry to the corresponding webhook event and API response. This makes it straightforward to trace a message end-to-end across your system — from the API call that triggered it, through the webhook status updates, to the final state in the log.

Use the **filter and search tools** to scope the log view to a specific time period or number, then review entries directly in the dashboard. This is useful for compliance reviews, debugging delivery failures, or auditing campaign performance.

<Info>
  Logs are retained for the duration of your subscription. Contact support for longer retention options.
</Info>