Agent's Guide: Managing Conversations

A comprehensive agent's guide on how to view and manage Inbox conversations integrated with SMS, WhatsApp, and Telegram platforms.

From the Inbox main menu, multiple inbox agents and/or managers can access the Inbox dashboard to concurrently view and manage the same team conversation, provided they have the corresponding Inbox role permissions.

❗️

IMPORTANT

To access and manage the conversations from the spaces and teams assigned to your account, you must hold the corresponding Inbox role.

A click on the conversation will open the timeline box containing the history of all its messages and events.

Every Inbox conversation has a platform icon (SMS, WhatsApp, or Telegram) shown next to its name, both on the Conversations list and in the conversation timeline. From this view, you can start a new conversation or view the details of any existing conversation.

Also, you can switch between Chat layout and Table layout using the two icons at the top of the Conversations list, to the left of the folder name.

Layout selector

Click on the existing conversation to see its details. Below, the message box with the editor is shown where you can write messages to customers or leave internal notes for other agents (provided the agent has the corresponding permission, Add internal notes for conversation).

The sidebar Details section on the right contains editable contact data and information about the conversation assignments, tags, and previous conversations with this contact, if any.


👍

TIP

CommPeak Dialer customers can also manage calls (both VoIP and WhatsApp Business) directly within the Dialer Inbox.

Check the Making WhatsApp Business & VoIP Calls article to learn more.

Creating New Conversations

To create a new conversation:

  1. Click the New Conversation button under your account name or Create new conversation in the middle of the page.

    Creating new conversation

  2. Select a TextPeak contact to create a new conversation.

    Selecting contact

  3. Then, click to select the assigned team.

  4. Click Next.

  5. In a new window, a sender, then click Next.

Screenshot of creating  new conversation: selecting sender

Selecting sender

If this is not a new contact, you will see the list of previous conversations with it; if needed, you can select the needed conversation to continue with it instead of initiating a new conversation.

📘

NOTE

Inbox agents have no access to the Settings page and can manage conversations only where they can view the name of the sender profile, not the senders it contains.

Therefore, when starting a new conversation, an agent can select the sender profile only and the system automatically selects one of its senders based on the country and the daily limit.

  1. Provide the message text, optionally, use the AI Assistants, Canned Response, and/or emoji options and click Send Message.
Screenshot of the New conversation dialog box: message text editor

New conversation dialog box: message text editor

  1. The message is sent, and the conversation is added to the Conversations list.

Using WhatsApp Templates

In TextPeak Inbox, you can use the WhatsApp templates for messaging.

To start a new WhatsApp conversation:

  1. Click the New Conversation button under your account name.
  2. Then, select a TextPeak contact to create a new conversation. Then, click to select the assigned team and the sender from the drop-down menus, then click Next.
  3. To start your conversation, click Select template.
Screenshot with selecting template

Select template button

📘

NOTE

You can check the Managing WhatsApp Templates article for details about how to create and manage the templates created with WhatsApp.

  1. Next, select the template to be used for your conversation.
Screenshot of selecting WhatsApp emplate

Selecting WhatsApp Templates

  1. For complex templates, you may need to provide the message body/placeholders to be used in the message, for example, the recipient's first and last names.
Screenshot with filling the message placeholders

Filling the message placeholders

  1. Click the button below to send the message.
  2. ✔️ Congratulations! Your message is sent.

Conversation Timeline

In the conversation timeline box, agents can review the history of this conversation in chronological order, including:

  • all messages shown with the time stamp and their status (Sent, Read, Delivered, etc.)
  • badges with information about any past event, for example, changing status or adding tags
  • internal notes shown with the time stamp
  • avatars of the agents involved in the conversation.
Screenshot of the inbox conversation timeline box and merssage editor

Inbox conversation timeline and message editor

📘

TIP

Starting from v1.06, you can see the reactions your contacts add to WhatsApp messages, right in the conversation timeline.

Screenshot with the conversation reaction

Conversation reaction

Managing Messages

Below the conversation timeline is the message box, where inbox agents can write messages to customers under the Sender Profile tab or switch to the Internal note tab to leave notes for other agents or managers.

Screenshot of the Sender Profile and Internal note tabs

Switching between the Sender Profile and Internal note tabs

📘

NOTE

Internal notes can only be accessed by the agents assigned with the corresponding Inbox role permissions.

While writing your message, you can also select to do the following (left to right):

Screenshot of the message editor options

Message editor options

  • attach a file (only for WhatsApp Business and Telegram messages) - provided your manager enabled this functionality for your account

  • insert an emoji.

    Screenshot with adding emojis

    Adding emojis

When you finish, click the send icon. If your manager has turned on Undo send, an undo control appears for a few seconds so you can pull the message back before it goes out. The length of that window is the Seconds to undo value, set per space - if you never see the control, undo is turned off for your space. See the General Settings page.

Screenshot of the message editor with the sending Undo button

Message sending Undo button

For WhatsApp Business conversations, you can get voice/audio messages with video messages showing a preview upon download:

Screenshot of media preview

Media Preview

📘

NOTE

Note that sending of docs and media in WhatsApp Business conversations can be disabled by your Inbox Manager.

Using AI Assistants

You can use AI assistants for generating your Inbox messages.

📘

NOTE

Check the following articles to learn how you can integrate TextPeak Inbox with:

To use the AI assistant options, in the message box, click the AI Assistant button and select the preferred option, then proceed with composing your message:

Screenshot of selecting AI Assistant options

Selecting AI assistant options

Respond

Use it to create a response to the message that is based on the message history.

Before you can generate responses, your Inbox manager must create conversation goals for your team.

Screenshot of the dialog for generating response

Generating response dialog

Improve with AI

Select it to open the box where you can enter the message you want to rewrite, then select the message tone, and click AI Rewrite.

Screenshot of rewriting message with AI

Rewriting message with AI

Generate message

Use this option to enter prompts to generate engaging and grammatically correct messages. Here, you can also limit the message length.

Screenshot of generating message with AI

Generating message with AI

Details

The Details panel opens on the right when you select a conversation and click the button at the top right of the conversation timeline.

Details button

Each section expands and collapses independently:

  • Contact Data: the contact's Phone, Country, First Name, Last Name, Email, and City. Click Edit to change them. Country is derived from the phone number and is not editable on its own.

  • Conversation Assignment: the team and Agent handling the conversation, each a drop-down.

  • Conversation tags: the tags applied to the conversation, with Add to apply another. Click Save changes to confirm.

  • Previous conversations: this contact's earlier conversations, each with its date and status. For more details, see the Previous Conversations page.

    Details section

Managing Contacts

To edit an existing inbox contact:

  1. Expand the Contact Data section and click Edit.

    Screenshot of the dialog confirming editing contact data

    Editing contact data

  2. In the dialog window, update the contact data.

Screenshot of the dialog confirming updating contact data

Updating contact data

  1. Click Save Changes.

Managing Conversation Assignments

To edit conversation assignments:

  1. Expand the Conversation Assignment section and click Edit.
  2. Click to open the drop-down menus and select the teams and agents you want to assign to this conversation.
Screenshot of the dialog confirming editing conversation assignment

Editing conversation assignment

  1. Click Save Changes.

Managing Conversation Tags

To add or edit conversation tags:

  1. Expand the Conversation tags section and click + Add.
  2. Select the tags you want to add.
Scrreenshot of the dialog for adding conversation tags

Adding conversation tags

  1. Click Save Changes.
Screenshot of the dialog confirming saving added tags

Saving added tags

  1. The tags are saved and can be used in conversations.

Viewing Previous Conversations

To view previous conversation with this contact:

  1. Expand the Previous conversations section.

  2. Here, you can see the conversation type label, contact number, date of latest contact, the most recent message text, and the conversation status.

    Previous conversation

  3. To open this conversation in a new window, click the redirect button.

    Opening the conversation

Sorting Conversations

  1. To sort conversations, select one of the following options:

    • All conversations - review all conversations available to them
    • Assigned to me - review the conversations that are assigned to them only
    • Closed - review the conversations closed by them.
    Screenshot of the conversation sorting options

    Conversation sorting options

  2. If several teams are created under your account, you can review conversations assigned to the specific team by selecting the needed team under Teams.

📘

NOTE

If an agent belons to multiple spaces, they can switch between them by clicking the top arrow button and selecting the needed space from the drop-down list.

Screenshot of the button for switching between spaces

Switching between spaces

  1. You will see the list of the sorted conversations in the Conversations menu on the right. Every conversation is shown with the platform icon (SMS, WhatsApp, or Telegram), contact name/number, last message, and a three-dot menu button to update the conversation status.

Saving your filters as a view

If you rebuild the same filters every day, save them as a view instead. Pinned views appear under VIEWS in the Inbox sidebar and update in real time as conversations change.

Pinned views

To create one, click + next to VIEWS. For the full flow, see the Custom Views page.

Conversation Statuses

Every new conversation started from TextPeak API, CommPeak Dialer, or TextPeak SMS Campaign is automatically generated with the Unanswered status. Once the contact answers the message, its status updates to Active, and the conversation is ready to be processed by the agent.

  1. You can search conversations by contact name or message text.
Screenshot of the Search field and the button for filtering conversations with unresad messages

Search field and Filter button

  1. You can also filter to show specific conversations by clicking the button next to the Search field. Filters are grouped by Conversation Status, Channel & Status and Conversation state. You can combine them; for example, WhatsApp + Within 24 hours to find conversations where you can still send a free-text reply.
  1. Screenshot of the conversation Filters panel

    Filters panel: channel and status options

    Refer to the following table for filter descriptions:

    FilterDescription
    Conversation Status: AllReview all conversations available.
    Conversation Status: ActiveReview the conversations that are currently active.
    Conversation Status: UnansweredReview the unanswered conversations.
    Conversation Status: ClosedReview the closed conversations.
    Channel & Status: SMSShow only conversations on the SMS channel.
    Channel & Status: WhatsAppShow only WhatsApp Business conversations.
    Channel & Status: UnreadConversations with messages you haven't read yet.
    Channel & Status: Within 24 hours

    WhatsApp Business conversations where the contact has sent a message in the last 24 hours, so you can still send a free-text reply.

    The 24-hour window resets every time the contact sends a new message.

    Channel & Status: UnassignedConversations that are not yet assigned to any agent.
    Channel & Status: Call permissionWhatsApp contacts within their callable window — meaning you can place a WhatsApp Business call without sending a template first.
    Conversation state: Pending agentConversations waiting on a response from your side.
    Conversation state: Pending contactConversations waiting on a response from the contact.
    Conversation state: Failed messageConversations whose most recent outbound message failed to deliver.
  1. A list of conversations will be returned, each with the platform label (SMS, WhatsApp, or Telegram), contact name or number, date, and the label showing the number of unread messages.

    Note, that the 24-hour window for free-text messages is renewed every time the contact sends a new message.

  1. To update the conversation status from the Conversations list, hover over a conversation, click the three-dot menu button on the right, and select the new status to assign it to the conversation.
Screenshot of the option to assign a new status to conversation

Assigning a new status to conversation

  1. You can also update the status from the conversation thread box by clicking the arrow button and selecting the new status to assign to the conversation.
Screenshot of the button for updating conversation status

Updating conversation status

📘

NOTE

You cannot change the active or closed conversation's status back to Unanswered.

Sharing Conversation Links

To copy and share a conversation link to quickly reference specific chats with your team members, click the link button next to the conversation status badge and share it.

Screenshot of copying a conversation link

Copying conversation link


Did this page help you?