Skip to main content
All CollectionsInboxConversationsBest practices
Using conversation data in the Inbox
Using conversation data in the Inbox

Learn how to create and use conversation data attributes for advanced inbox management.

Beth avatar
Written by Beth
Updated this week

With the Intercom Messenger installed on your site or in your app you’re already offering your customers an easy, personal support experience. But, as your business grows you need to provide your team with simple, effective processes so they can handle any number of more complex conversations without burnout or inefficiencies.

This is where conversation data attributes (CvDAs) come in, enabling advanced inbox processes and automation. Let your team handle conversations efficiently and consistently, like with a traditional ticketing system, without losing the personal experience of the Messenger. You get the best of both worlds.

With the right conversation attributes, any conversation can be managed efficiently from start to finish. Your customers can provide context up front without the hassle of a form, and rules-based automations can update conversation attributes automatically. These attributes can then be used in inbox views, rules, and reporting to design and manage different support processes for different types of conversations.

If you’ve switched to Intercom from a traditional ticketing system, "conversation data attributes" are comparable to "custom ticket fields". 👌

In this article we’ll work with three example conversation attributes:

  • Product area — Grouping conversations by different parts of your product allows you to have specialist teams handle different features, or break down your reports for a deeper insight into which areas have the most impact on your support team.

  • Type — Labeling different categories of conversation like ‘Bug’, ‘Feature request’, or ‘Question’ lets you see trends in real time views, or over time in reports.

  • Urgency — Defining an urgency for each conversation is the perfect way to ensure that every customer gets the right level of support. For example, you might consider all conversations from VIP customers as high urgency.

The article will explain:

  • How to create and use conversation data attributes (CvDAs) in the Inbox.

  • How to collect them from your customers at the start of a conversation.

  • Using CvDAs to build a custom view of your Inbox.

  • How to set CvDAs using rules-based automations.

  • How to filter your reports with CvDAs, for an in-depth understanding of the conversations your team are handling.

We’ll also finish with a checklist of steps you can follow to set up the ideal process in your own workspace. 🙌


Create and use conversation data attributes (CvDAs) in the Inbox

To create a new conversation attribute, go to Settings > Data > Conversations and click + Create attribute.

For our example "Product Area", let’s create a List attribute and add options for the different parts of the product (as the product changes we can always add or remove options):

The name may be visible to customers if you collect this information in conversations.

Require this attribute

To ensure that this CvDA has a value set before a conversation is closed, you can set it as required. This guarantees accurate and comprehensive reporting. Just select Required attribute.

Then, if a teammate attempts to close a conversation before providing this value, they'll be reminded to set it:

This setting only applies to human admins in the Inbox and the mobile app. Conversations will still close without filling in the required attributes in Workflows and the API.

Restrict visibility for this attribute

If the conversation data you're collecting is only relevant for certain conversations, you can restrict its visibility to certain teams.

For example, your Sales team might set an attribute for each lead's intended use case, but this is no longer relevant for the folks in Customer Support:

If you set a CvDA as required, and limited to certain teams, only conversations assigned to those teams will require it.

And that’s it. Just hit save and you’ll see your new CvDA under "Attributes", where your team can easily set or update it as they chat with your customers.

Note: Conversation attributes can only be populated when a conversation is created. When a teammate is drafting a new conversation, the conversation does not exist until they press the Send button. Once they press Send and a conversation gets created, the attributes and their values will appear automatically.

Conversation data attribute limits

The total number of CvDAs per workspace is limited to 5000. This is the combination of attributes created for conversations and all ticket types.

The exception is when creating text attributes. There’s a limit of 250 text attributes for conversations and 250 text attributes for each ticket type.

For example, if a Customer ticket is created and there’s 250 text attributes for conversations, and 250 text attributes for the customer ticket type, the ticket can have 500 text attributes. This is the maximum number of text attributes a conversation/ticket can have. However, you'll still be able to create attributes of different types (up to 5000).

Reordering your conversation data attributes

To choose a specific order in which the attributes should appear, drag and drop them with the handle icon on the left:

Conversation tags & conversation data attributes - what’s the difference?

Tags are very flexible, and applied to individual replies in a conversation. Useful for marking a particular part of the conversation so you can find it later.

Conversation data attributes are more structured, because you can define the data type that should apply: text, numbers, true/false or a list of values. They're perfect for ensuring consistency and categorizing all of your conversations for reporting purposes. For example, by type, urgency, product area etc.

Some examples:

  • Number attributes let you attach a value to a conversation, for example if you have an attribute like “Order value”. You can then filter reports for conversations where order value is greater than a certain value.

  • List attributes allow you to have exactly one of a set of values. For example, if you have a “Priority” attribute it could be set to "high, medium, or low". You can then use these attributes as filters for Inbox Views, and conversations will move in and out of views in real time.


Collect conversation data up front from your customers

To save your teammates time you can collect conversation data up front from your customers, then based on their answers, automatically assign conversations to the right team with the right service level and priority.

It's easy to set this up using Workflows (or Basics) to build a bot automation.


Set conversation data attributes automatically with Workflows

CvDAs can also be updated automatically using Workflows. For example, if a new message contains keywords like "Bug" rules can set the conversation issue to "Bug report":

Or, you may want to infer certain attributes based on other conversation information. These examples set the Product Area conversation attribute based on the URL where a conversation is started:

Rules can be triggered throughout the entire conversation to keep your conversation data up to date as things progress. Learn more about creating and managing rules-based automations in Workflows.


Set conversation data attributes with macros

CvDAs can also be updated automatically actions in macros. For example, if a conversation is being escalated due to an error, your escalation macro could set the conversation type to "Bug report":


Build a custom view of the Inbox based on conversation data attributes

Inbox Views allow you to define a set of filters, then show all conversations that match those filters in real time. It’s easy to switch between views and keep an eye on urgent issues, your direct reports, or whichever conversations you consider most important.

As an example, imagine you’ve just released an update to the "Projects" feature in your product, and you’d like to monitor all serious bugs being reported. This view uses all three conversation attributes to show conversations where:

  • Product area is ‘Projects’ and Type is ‘Bug’
    And

  • Urgency is ‘Medium’ or ‘High’

Here’s a couple of other views we recommend:

  • Conversations with a high urgency — See a real time view of urgent conversations, to ensure your team has everything they need to handle them.

  • Longest waiting conversations — Highlight conversations that haven’t received a reply recently.

  • Conversations assigned to specific people — Look out for newer members of your team, who might need a hand. 😉


Filter your reports with conversation data attributes

CvDAs not only speed up your inboxing processes but give you consistent, well-defined reporting, on exactly the points that matter to you and your team.

Filtering your Customer Support reports with CvDAs lets you dig into specific areas, for actionable insights into how your team is performing.

To continue with the example from above, let’s say it’s been a week since you launched the update to your "Projects" feature and you want to see how satisfied your customers have been with responses to their questions. Just filter the Customer satisfaction report template for all conversations where:

  • Product area is "Projects"
    And

  • Type is "Question"

Or, for an alternate approach, use the Responsiveness report template for all conversations where Type is "Bug", and see how quickly these issues are being resolved.


Support manager’s checklist for inbox excellence

Now that you know how to get the most out of conversation data it’s time to create your own attributes and set your workspace up for success. Just follow this simple checklist:

  1. Define the right conversation data for your business
    Create your first conversation attributes now.

  2. Get context up front from your customers
    Set up a Workflow or Basic automation to collect conversation attributes when someone starts a new conversation.

  3. Set conversation data automatically with Workflows
    Ensure conversations are handled by the right people, in the right order, with all the right context using background rules.

  4. Create views that show you exactly what you need to see
    Create an Inbox View for a customized list of conversations.

  5. Bonus: Join the Intercom Community and chat with other power users for best practice advice, pro tips and more. 🚀


💡Tip

Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts


Did this answer your question?