# Messages

## Getting Here <a href="#getting-here" id="getting-here"></a>

This module can be accessed from the side navigation menu under the menu item, **Messages**

## Navigati**ng around**  <a href="#navigating-around" id="navigating-around"></a>

Messaging Module has 5 main sections

1. Contact View Selector
2. Contact List
3. Messaging Console
4. Conversation Action
5. Contact Details

![The Messages Module](/files/-MTBUvW_Cc6zO5XWJl3p)

## ​Contact view selector

The view selector is a dropdown where you can select different views of the contacts.

### Showing my contacts

There is a quick option to show contacts assigned to you only by pressing on **Mine** at the contact view selector. This quick option can help you retrieve the list of assigned contacts so you can do what you needed to do with it.

### Notification Indicators <a href="#notification-indicators" id="notification-indicators"></a>

![Notification Indicators](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-M5_sMySrVzhTtYbDpPu%2F-M5a2ih9x4NcfGvX8u6z%2Fimage.png?alt=media\&token=85ec1517-3e6e-4ed7-8d9b-d042626f2519)

The Notification Indicators show the number of contacts available in a chosen filter.

As for the color, please refer to the following:

| Indicator color | Description                                            |
| --------------- | ------------------------------------------------------ |
| Blue            | There are no unread messages                           |
| Red             | There are unread messages that requires your attention |

{% hint style="info" %}
Using the example above, it simply means: 1. There are 5 contacts in the **Unassigned** view. 2. There are 2 contacts assigned to the user and there are unread messages present.
{% endhint %}

Based on the view selected, the list of contacts can vary depending on the view criteria. The contact list is located at the left of the Messaging Module and it refreshes every time a new view is selected or a message is received.

Whether or not you are sending a message or simply want to review past conversations, you must first select a contact you want to view.

By default, the contact list is sorted by the most recent message.

#### Conversation Indicators <a href="#conversation-indicators" id="conversation-indicators"></a>

{% hint style="info" %}
If you need a find a specific contact or conversation quickly, you can use the search bar at the top and do a search.
{% endhint %}

## 3. Messaging Console <a href="#id-3-messaging-console" id="id-3-messaging-console"></a>

Messaging Console is where you can view the messages received from a contact and you can compose or draft messages to respond to the contact. When a contact is selected from the contact list, the conversation history will load including the [Message Metadata](/bonomi-inbox/messages.md#3-messaging-console) and [Conversation Events](/bonomi-inbox/messages.md#conversation-events).

### Message Metadata

When you hover a message, the message metadata will show in a callout. The metadata consists of the sender of the message and timestamp of the message statuses.

![](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-MBblqJ5RmgxsRPEr4A8%2F-MBbuxB3tDWrrynsGH44%2Fezgif-6-deedbbc40d7b.gif?alt=media\&token=f32b8a58-df15-411b-ae54-16d4b8eab6d3)

Refer to [Message Status](/bonomi-inbox/messages.md#message-status) for more information on the different message statuses.

As for the sender, it indicates where the message was sent via.

### Message Status <a href="#message-status" id="message-status"></a>

When a user sends a message to the contact, the user can check on the delivery status to ensure the message is delivered.

You can check on the delivery status of a message by hovering over the message

![Hover over a message to check the deliverability of a message](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-M7kHTETqd7k5Y44rva0%2F-M7kP1Tzmim5dANwUwLC%2Fstatus1.gif?alt=media\&token=6acaf0a4-0deb-40ba-8595-2bf6d30e0feb)

For each message sent to the contact, there will be an indicator that indicates the status of the message. The statuses are described as follow:-

| Status    | Icon                                                            | Description                                            |
| --------- | --------------------------------------------------------------- | ------------------------------------------------------ |
| Sent      | <img src="/files/-MTLb6XxFob2J9KWuum9" alt="" data-size="line"> | The message is successfully sent                       |
| Delivered | <img src="/files/-MTLbG8YksY6-8_oXK9V" alt="" data-size="line"> | The message is successfully delivered to the contact   |
| Read      | <img src="/files/-MTLbHTX6p9kKQ6rSNti" alt="" data-size="line"> | The message is read by the contact                     |
| Failed    | <img src="/files/-MTLbIcmjIVJvK_AH9M_" alt="" data-size="line"> | There was a failure sending the message to the contact |

{% hint style="warning" %}
Message Status is only applicable to messages sent within the messaging window of the channel
{% endhint %}

{% hint style="info" %}
Some messaging channels have limited coverage of message status, please refer to this [table ](/channels-overview/untitled.md#channels-summary)on the coverage for each channel.
{% endhint %}

{% hint style="danger" %}
If the message failed to be sent to the contact, hover over the message and it will describe error from the platform or the channel source.
{% endhint %}

### Conversation Events <a href="#conversation-events" id="conversation-events"></a>

The Message History will also keep track of important events, such as when a Contact was previously marked done and by who.

![A Marked Done Event](https://gblobscdn.gitbook.com/assets%2F-L8qsmIDw5_reabURkaE%2F-LrIGcc9MWloXVlsQb9M%2F-LrII8aE9qO6bih2usX4%2FMarked%20Done%20Event.png?alt=media\&token=25fb8f87-14aa-4947-ae7c-aabc6fa53872)

| Event Category    | Event                                                                                                                                                                                                                                            |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Assignment        | <p>User Assigned <br>User Assigned by Automation</p><p>User Assigned by Bot</p><p>Failed to Assign</p>                                                                                                                                           |
| Marked Done       | <p>Marked Done (Manual)</p><p>Marked Done by Automation</p><p>Marked Pending (Manual)</p><p>Marked Pending by Automation</p><p>Marked Pending by Bot</p>                                                                                         |
| Snooze            | <p>Contact Snoozed</p><p>Contact Unsnooze</p>                                                                                                                                                                                                    |
| Broadcasts        | Broadcast Sent                                                                                                                                                                                                                                   |
| Survey            | <p>Survey Started</p><p>Survey Started by Automation<br>Survey Started by Broadcast<br>Survey Canceled<br>Survey Canceled by Automation<br>Survey Canceled by Broadcast<br>Survey Canceled by API</p><p>Survey Completed</p><p>Survey Failed</p> |
| Bot Status Update | <p>Bot Status Off </p><p>Bot Status Off by Automation</p><p>Bot Status Off by Bot</p><p>Bot Status On </p><p>Bot Status On by Automation</p><p>Bot Status On by Bot</p>                                                                          |
| Channel           | Event coming from Channel                                                                                                                                                                                                                        |
| Page Change       | Event when a visitor navigates to a different page (Web Chat)                                                                                                                                                                                    |

### Sending Messages <a href="#sending-messages" id="sending-messages"></a>

Here is a quick guide on how to send messages to your contacts.

**Important:** Some messaging channel has a limited messaging window and you may face challenges to send a message. Be sure to plan your replies ahead to ensure your message is delivered. Find out more about [Messaging Window](/channels-overview/untitled.md#messaging-window)!

## 4. Conversation Action <a href="#id-4-conversation-action" id="id-4-conversation-action"></a>

### Assignment and Mark Done <a href="#assignment-and-mark-done" id="assignment-and-mark-done"></a>

Assigning a contact and marking it done work in tandem to help you and your team stay organized when dealing with an influx of conversations. Assign contacts to specific agents and archive resolved conversations by marking it done.

Learn more about assigning conversations:

{% content-ref url="/pages/-MTBMi2YYluTdKowVpkV" %}
[Assignment and Mark Done](/bonomi-inbox/messages/assignment-and-mark-done.md)
{% endcontent-ref %}

Read more about [contact details](/bonomi-inbox/contacts/contact-details.md).


---

# Agent Instructions: 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:

```
GET https://docs.bonomi.io/bonomi-inbox/messages.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
