Message List
The message list is the main area of the Failed Messages page. It shows every failed message that matches your current filters, with all the details you need to understand what happened and take action.
Desktop View — Table Layout
On desktop, messages are displayed in a table with 9 columns:
2. Capture the full table showing all columns, including messages with different error categories and retry statuses
Save to:
static/img/screenshots/failed-messages/message-list/message-table-desktop.png| # | Column | What it shows |
|---|---|---|
| 1 | S.No | Row number |
| 2 | Checkbox | Select individual messages for bulk actions |
| 3 | Time | When the message failed — includes a countdown timer, relative time (e.g., "2 hours ago"), and a retry attempt badge if applicable |
| 4 | Contact | The recipient's name and phone number |
| 5 | Error Reason | The error name with an info icon — click the icon to see full error details |
| 6 | Category | A colored badge showing the error category (Retryable, Non-Retryable, or Business Logic) |
| 7 | Campaign | The campaign name, template name, and a preview icon to see the message content |
| 8 | Retry Status | Whether the message has been retried and the result |
| 9 | Actions | A three-dot menu (⋮) with available actions |
Time Column Details
The time column packs a lot of useful information:
| Element | Description |
|---|---|
| Countdown timer | Shows how much time is left before the recommended retry window opens (e.g., "Retry in 18h 30m") |
| Relative time | How long ago the message failed (e.g., "2 hours ago", "yesterday") |
| Retry attempt badge | If the message has been retried, a colored badge shows the attempt number |
Retry attempt badges:
| Badge | Color | Meaning |
|---|---|---|
| No badge | — | This is the original message (no retries yet) |
| Attempt #2 | Orange | The message has been retried once |
| Attempt #3+ | Pink/Red | The message has been retried two or more times |
2. Capture a close-up of the Time column for 2-3 messages showing different states
Save to:
static/img/screenshots/failed-messages/message-list/time-column-details.pngError Reason Column
Each row shows the error name along with a small info icon (ⓘ). Click the info icon to open the Error Info dialog with full details about the error.
Save to:
static/img/screenshots/failed-messages/message-list/error-reason-column.pngCategory Badges
The category column shows a colored badge for each message:
| Badge | Color | Meaning |
|---|---|---|
| Retryable | Green | Temporary issue — can be retried |
| Non-Retryable | Red | Permanent failure — cannot be retried |
| Business Logic | Yellow | Business rule violation |
2. Capture the Category column showing all three badge colors
Save to:
static/img/screenshots/failed-messages/message-list/category-badges.pngCampaign Column
This column shows:
- The campaign name (the broadcast or automation that sent the message)
- The template name used
- A preview icon (eye icon) — click it to see the message exactly as the customer would have received it
Save to:
static/img/screenshots/failed-messages/message-list/campaign-column.pngActions Menu
Click the three-dot menu (⋮) on any row to see the available actions:
| Action | When available | What it does |
|---|---|---|
| Retry | When the message is eligible for retry | Opens the retry confirmation dialog |
| View History | Always | Shows the full retry history timeline for this message |
| View Statistics | Always | Opens detailed retry statistics |
| View Error Details | Always | Opens the error information dialog |
2. Capture the expanded dropdown showing all available actions
Save to:
static/img/screenshots/failed-messages/message-list/actions-menu.pngThe Retry option only appears when the message meets all retry eligibility rules. If you don't see it, the message either has a non-retryable error or hasn't reached the recommended wait time yet.
Selection & Bulk Actions
You can select multiple messages to perform bulk actions:
- Click the checkbox next to each message you want to select
- Or click the header checkbox to select all visible messages
- A bulk actions bar appears at the top when messages are selected
2. Capture the bulk actions bar that appears at the top showing the count and retry button
Save to:
static/img/screenshots/failed-messages/message-list/bulk-actions-bar.pngThe bulk actions bar shows:
- How many messages are currently selected
- A Retry Selected button to retry all selected eligible messages at once
Only eligible messages in your selection will be retried. Messages with non-retryable errors or that haven't reached the wait time will be skipped. The retry results dialog will show you which ones were queued and which were skipped.
Mobile View — Card Layout
On smaller screens, the table transforms into a card-based layout. Each message is shown as a card with all the same information stacked vertically for easy reading on mobile devices.
2. Capture the card-based layout showing 2-3 message cards
Save to:
static/img/screenshots/failed-messages/message-list/mobile-card-view.pngEach card includes:
- Contact name and phone number
- Error reason with category badge
- Time information with countdown
- Campaign and template name
- Retry status
- Action buttons
Pagination
By default, the list shows 20 messages per page. You can change this using the page size selector at the bottom:
| Option | Messages per page |
|---|---|
| 10 | 10 |
| 20 | 20 (default) |
| 50 | 50 |
| 100 | 100 |
Use the page navigation controls to move between pages.
2. Capture the pagination area showing the page size dropdown and page navigation arrows
Save to:
static/img/screenshots/failed-messages/message-list/pagination.png