Before reading this article, we recommend reading the deep dive on:
Understanding how tickets look like in practice, will help you decide on the right configurations for your team.
Get started
To be able to create tickets from the Inbox, you need to first create the ticket types you want to use. A ticket type defines the data fields to be captured in the ticket and its category.
Ticket types can be set up from Settings > Inbox > Tickets.
Only teammates with Can manage workspace data permission can set up ticket types.
Create new ticket type
Step 1 - Click on Create ticket type in the top right corner
Step 2 - Select the ticket category: Customer, Back-office, or Tracker ticket
Customer tickets - When your team needs more time to work on issues, use Customer tickets to capture, track and automatically share progress with the customer.
Back-office tickets - When a Support rep needs to collaborate with back-office teams to resolve an issue, create a linked Back-office ticket from a conversation for seamless collaboration.
Tracker tickets - Streamline problems impacting many customers, such as bugs, service interruptions, and feature requests.
Learn more about the three high-level tickets use cases.
Step 3 - Specify the ticket type icon, name, and description
Give your ticket type a meaningful name. Note: this name will be visible to customers if you share the ticket with them. Visibility to customer is unique for each ticket category:
Customer ticket- always shared with the customer.
Back-office ticket - internal only by default, but can be optionally shared with customers.
Tracker ticket - internal only and never shared with customers.
The ticket type description is never shared with the customer and is primarily to help your team know when to use this ticket type.
Step 4 - Review customer sharing settings
Customer sharing settings are different across the three categories: Customer, Back-office, and Tracker tickets.
Category | Customer visibility | Communication |
Customer tickets | Always shared with customers.
|
|
Back-office tickets | Internal only by default.
Can be optionally shared with customer.
|
|
Tracker tickets | Internal only, and never shared with customers. |
|
Create ticket attributes
Default attributes
All ticket types come with two default attributes: title and description.
The title and description fields are clearly surfaced while viewing a ticket in the Inbox. You can also search by ticket title and description.
By default, the title and description are not visible to customers and are optional for teammates. You can modify their visibility setting if needed by clicking on the edit icon.
Add a custom attribute
In addition to the default title and description, you can create custom ticket attributes. Start by clicking on + Add attribute at the bottom of the ticket attributes section.
Select a format
Then, select the attribute format: text, list, number, decimal, boolean, date/time, or file upload.
Pro tip: When using the Text format, enable the “Multiline” option to give your team and customers more space for details. We recommend enabling it for anything with more than 30 characters.
Note: When using "Decimal Number" attribute type, the format accepted is using a period (.), for example: 10.5. Commas and other symbols are not currently supported.
Give the attribute a name and description
Give the attribute a meaningful name and description. If you set the attribute as visible to customers, they will be able to see its name in Messenger and via email.
The attribute description however is internal only and is meant to help your team better understand the attribute.
Review the customer settings
Depending on the ticket type category where you’re creating the attribute, the customer related settings surface different options.
Category | Customer settings |
Customer tickets | Customer tickets are always shared with customer, however you control which attributes are visible.
|
Back-office tickets | When ticket type settings = can’t be shared with customer (this is the default)
When ticket type settings = can be shared with customer
|
Tracker tickets | Attributes are never visible to the customers as Tracker tickets are always internal only. |
Review the teammate settings
By default, attributes are visible to teammates when they’re creating a new ticket from the Inbox and when looking at an existing ticket. You can hide an attribute from the creation form, and make it only visible when looking at an already created ticket by disabling the first checkbox.
You can also make an attribute required for teammates when creating a new ticket, by enabling the second checkbox.
Note:
Ticket type names and attributes don’t get translated / localized in the Messenger even if you support multiple languages.
You can’t modify the ticket attribute format once it is created. You can create a new attribute with the desired format and archive the old one.
File upload attributes support all common file formats.
Ticket data attribute names can be no longer than 191 characters.
Ticket type and data attribute descriptions can be no longer than 255 characters.
Each ticket type can have a maximum of 50 attributes.
Upload list attribute options via CSV
Instead of adding each list attribute option manually, you can import up to 1000 options at once using a CSV file.
Navigate to Settings> Inbox> Tickets> Ticket Types and select the relevant ticket type.
In the attributes section at the bottom of the page, select a list attribute you want to edit.
Prepare a CSV file containing your list options in the appropriate format:
At least one column for the "Name" of the option. The first column in the CSV file will be used for the import.
The first row will be treated as a header column and won't be imported.
Any blank rows will be ignored and not imported.
Import your options from your CSV file.
Click Upload at the bottom of the screen
Choose your file and upload the options.
Click Add options to import your List options.
Save your attribute.
Note:
Your CSV can't contain duplicate attribute option names. Duplicates are case sensitive e.g. "Option 1" and "option 1" will be treated as two distinct options.
If you import a CSV after options are already available, this will add additional options, and won't update, archive, or replace existing options.
Add list attribute options manually
You can also add list attribute options one by one.
And that’s it. Just hit Save and you’ll see your new ticket attribute is now available for this ticket type.
Edit existing ticket type
To modify the ticket type category, icon, name, description, states, attributes or customer sharing settings, go to Settings > Inbox > Tickets. Then click on the edit icon next to the ticket type name.
From here, you can also duplicate a ticket type by clicking on the duplicate icon.
Archive a ticket type
You can archive (and restore) a ticket type you've created. Go to Settings > Inbox > Tickets and click the edit icon next to the ticket type. Then select Archive button in the top right.
To restore a ticket type, go to Settings > Inbox > Tickets and select Archived from the dropdown at the top. Then find the ticket type and click the restore icon next to it.
Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts