Skip to content

Route tickets in help desk based on agent skills

Last updated: May 3, 2024

Available with any of the following subscriptions, except where noted:

Service Hub   Enterprise

Requirements

To set up skill-based routing, the following requirements must be met:

  • You've connected an email or form channel to help desk.
  • Any teams or users that you want to assign skills to must have a Service Hub Enterprise seat.

Create and manage skills

To create and manage skills in your account:

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Routing.
  • In the top right, click Manage skills.
  • All your current assignable skills will appear to review in the table. Skills can include languages that your team is fluent in, or custom skills (e.g., a specialization in a specific part of your business).
    • By default, HubSpot's supported languages will be listed as skills you can associate with members of your team, either as their main or secondary language.
    • To edit a skill, click the Skill name
    • Hover over a skill and click Actions, then select from the following options:
      • Rename skill: edit the name of the skill.
      • Rename category: edit the name of the category:
      • See rules with this skill: see which rulesets are assigned the skill.
      • See users with this skill: see which users are assigned the skill.

2024-04-04_14-57-39

      • Delete: permanently remove the skill from your account. Skills cannot be deleted if they're currently assigned to a user in your account.

2024-04-23_14-49-40

  • To create a new skill:
    • In the top right, click Create skill.
    • In the dialog box, click the Category dropdown menu, then select a category.
    • Enter a name for the skill.
    • To create multiple skills per category, click add Add another skill.
    • Click Save.

Screenshot 2024-04-02 at 13.56.33

The new skill will appear in the table and will be assignable to users and teams with a Service Hub Enterprise seat.

Assign a skill to a user

To associate a skill with a user:

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Users & teams.
  • Hover over a user, click the Actions dropdown menu, then select Edit user.
  • Click the Skills tab.
  • Customize the user's custom skills by clicking the User skills dropdown menu and selecting the checkbox next to any custom skills you've created.
  • Set the user's language skills in the Language skills section: 
    • Click the Main language dropdown menu and select the checkbox next to any language that the user is highly fluent in. This level of fluency implies that the user can handle industry-specific terms or situations where advanced fluency is required.
    • Click the Secondary language dropdown menu and select the checkbox next to a language that the user has conversational fluency in. Setting a secondary language implies that the user is comfortable chatting with customers in that language but might not have enough knowledge to help them navigate industry-specific or legal copy where clear communication is important.
edit-skills-for-user
  • When you're done customizing the skills associated with a user, click Save in the bottom left.

Skill-based routing rules for tickets

After you've configured and assigned skills to users in your account, super admins and users with Account access permissions can create routing rules for each email and form channel connected to help desk.

Routing rules are organized as follows:

  • Each connected email or form channel can have one ruleset.
  • Each ruleset can have up to 19 sequential routing rules.

To create and organize your rulesets and routing rules:

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Routing.
  • Click Create ruleset.
  • In the right panel, enter a name for the ruleset, then select an email channel or form channel.
  • Click Next.
  • Customize a routing rule within the ruleset:
    • Enter a rule name.
    • Click + Add condition to configure which tickets will trigger the rule:
      • Add filters based on ticket properties, which can be configured in the Edit filter section after you select a property.
      • Filters can be combined within a single filter group by clicking + Add filter under the AND label, or by clicking + Add filter group under the OR label.
      • When you combine filters using AND, lists must meet all of the criteria in order to be included in the resulting filter view.
      • When you're done, click Save.
customize-conditions-for-ruleset-in-skill-based-routing
    • Click the Any team dropdown menu and select the checkbox next to any team that the filtered tickets should be routed to.
    • Click the Any skill dropdown menu and select the checkbox next to the associated skills of the users you want the tickets to be routed to.
    • Both teams and users are optional fields, so it's possible to route based only on skills or only on teams.
  • When you're done customizing your rule, you can click Save and create next rule if you want to create a new rule, or click Save in the bottom of the side panel to save your ruleset with the single rule and return to the ruleset page.
review-ruleset-and-rule-for-skill-based-routing

 

Review and edit routing rules

Once you've created a routing rule, the ruleset page will list each rule in a sequential list in priority order.

  • These routing rules will execute sequentially: if the conditions of the first rule are not met, the second rule will be tried, and this process will be repeated until all the rules are tried.
  • You can edit skill-based routing on both the channel settings page and the ruleset page. If a super admin or user with Account access permission changes the default routing rule on the ruleset page, the changes will be reflected on the channel settings page, and vice versa.
  • The Assign to available users only setting is synced and applied to the default routing rule on the channel. For example, if you set the default routing rule to Contact owner, it will assign to available contact owners only.

    2024-04-23_15-13-07
  • If no matches are found within a ruleset, the default routing rule will be used.
  • You can change the priority order of routing rules on the ruleset page by dragging them into a different order. You can also hover over a rule to edit, clone, or delete the rule.

review-rules-in-configured-ruleset-for-skill-based-routing

To toggle a ruleset on or off, click to toggle the Ruleset status switch on/off.

toggle-ruleset-status

 

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.