Set up a Queue in Teams
In order to create a Queue, you first need to create a Triage Team in Teams.
Create a Triage Team
- Naming conventions for Triage Teams are helpful - consider using something similar across all Triage Teams, like "[Team Name] - Triage"
- A Triage Team should always be private - membership of the Team in Teams is how Halp determines who is an Agent
- Once an Admin finishes configuring the Triage Team, members of the Triage Team will become Halp agents. This will affect your billing.
- If a user is already a member of an existing Triage Team, and therefore already a Halp Agent, you will not be double charged for them.
To set up a Triage Team, a Halp Admin must first add the Assist app to a private team in Teams.
- Create a new, private team in Teams.
- Once you’ve created the new private team, use the
...and select Manage Team
- Select Apps > click More Apps > search for "Assist" in the upper left corner. Click on the Assist app, and select Add to Team
- You’ll receive a prompt from Assist confirming which Team you’re adding Halp to, and click Set up a bot to proceed.
- You'll receive a chat in Teams from Assist. The Chat will ask you whether you’re wanting to create a Triage Channel (where agents can manage incoming tickets) or a Request Channel (where users can ask for help and create new tickets). Select Triage Channel.
Voilà! You've now both set-up your Triage Channel (where Agents will work on tickets) and created your first Queue 🥳. Assist will then send you a new message in that same chat with a few options.
- Jump to Triage Channel takes you back to the Triage Team you just created
- Jump to Assist tab takes you to the Assist app in Teams, where you can see all the tickets in the Queues you're a part of
- Open Queue settings takes you to the Halp web where you can customize your Queue's configuration, forms, fields, etc.
When you click "Open Queue Settings", you'll be brought to the Halp web app. There, Admins can view or edit the following Queue-level information:
- Configurations (edit)
- Agents (view)
- Fields (edit)
- Forms (edit)
- Statuses (edit)
- SLAs (edit)
- Hide Queue during Ticket creation: Users can create tickets in places that are not tied to a specific Queue. This happens when a user creates a ticket using Assist App home & DMs. When this happens, Assist will suggest a list of all Queues for the ticket to be created in.
- When enabled, the Queue will not appear in the list of suggested Queues to create a ticket in.
- When disabled, the Queue will appear in the list of suggested Queues to create a ticket in.
In the Queue settings, you're able to view the Agents who have access to the Queue. Agents are the members of a channel that is designated as the Triage Channel for a particular Queue. You may add and remove agents directly from Teams. Dive deeper into user roles.
Halp has Global Fields and Queue Fields.
- Global Fields are fields that appear in every queue (i.e. title)
- Queue Fields are fields that only appear in their Queue.
Note: If you are creating fields to sync with Zendesk, please follow this doc.
Queues can have an unlimited number of forms. Forms are a collection of global and/or queue fields. You must always have at least 1 form on each queue.
Forms populate in a few places.
- If a ticket is created via the Assist App Home where a Queue is not defined
- In a Request Team that is connected to a Queue
Creating a Form
- Navigate to Queues -> Forms
- Click Create
- Add any Queue Fields and Global Fields you would like to include on a form (you can mark certain fields as required).
Ticket statuses live at the Queue level and can be edited from the Queue Settings page. There are three status categories:
- Open: Tickets that are created and/or waiting for support
- In-Progress: Tickets that are pending or awaiting customer response
- Done: Tickets that are closed or completed
When a new Queue is created, the following default Status settings are in place:
- Three default statuses available (one per category): Open / Pending / Closed. You can add additional statuses to those categories, but you must keep at least one in the
- When a ticket is created, it will be assigned the default status in the
- If you click the “Close Ticket” button in Slack, the ticket status will change to the default
- The Status color will be grey. You can change the color of each status to better reflect your team's preferences.
An SLA (Service Level Agreement) are rules that you can set for your teams to ensure tickets are being handled in a timely manner. Halp SLAs can track when SLAs are breached, and send a message to the ticket and triage channel before it breaches. Learn more about SLAs.