Self-Service Assistant in Microsoft Teams
On this page
The Self-Service Assistant is a bot for Microsoft Teams that works with your organization's Alloy Navigator API. It is published to the Microsoft Teams store and added by a Microsoft 365 administrator. For how the bot is set up and configured, see Microsoft Teams: Self-Service Assistant Bot.
In Microsoft Teams
Add the assistant to Microsoft Teams
Once a Microsoft 365 administrator has added the assistant for your organization, add it to your own Microsoft Teams if it is not among your apps yet:
- In Microsoft Teams, select Apps.
- Search for the Self-Service Assistant, and select it.
- Review its description, and select Add.
For how Microsoft Teams adds apps, see Microsoft's article Add an app to Microsoft Teams.
How the assistant recognizes you
The assistant recognizes you by matching the email address of your Microsoft Teams account to the primary email address of your person record in Alloy Navigator. Because of this, once the bot has been added and connected to your organization's Alloy Navigator API, it is available to Self Service Portal customers without any further provisioning.
If the assistant cannot recognize you, it answers every command with an error message:
- If it finds no user with your email address, the message asks you to have your Alloy Navigator administrator check your account.
- If your Microsoft Teams account has no email address, the message says that you cannot use the assistant without one and asks you to contact your Microsoft 365 administrator.
Send commands to the assistant
To send a command in your chat with the assistant, select the message box and choose the command from the suggestions, or type the command, and then send it. Every command has a long and a short form, and you can type either in uppercase or lowercase letters:
list ticketsorlt- lists your open tickets.new ticketornt- opens the form for a new ticket.ticketort, followed by a space and a ticket number - shows that ticket.list approvalsorlap- lists the approval requests that wait for your decision.helporh- lists the commands with a short description of each.
Work with your tickets
To see your open tickets:
- Send
list tickets. - To open a ticket from the list, select View Details.
When you have many open tickets, the list shows the ten most recent ones and suggests the Self Service Portal for the complete list.
To create a ticket:
- Send
new ticket. - Fill in Summary and Description, and any other fields the form shows, as needed (see Report a technical issue).
- Select OK.
The assistant replies with the number of the new ticket. Select the number to open the ticket in the Self Service Portal.
To view or update a ticket by its number:
- Send
ticketfollowed by the ticket number. - To add a comment, select Update and fill in the form (see Add a comment to a ticket). To see the ticket's history of updates, select History.
Answer approval requests
- Send
list approvals. - To see the details of a request before you decide, select View Details.
- Select Approve or Reject, enter your comment (see Approve or reject a request), and select OK.
Use the assistant in other chats
You can send the assistant commands while you chat with other people or post in a channel, without leaving the conversation:
- In the compose area of the chat or channel, select Actions and apps.
- Select the Self-Service Assistant.
- Send it a command. The assistant answers in a pop-up window.
Create a ticket from a Teams message
The text of a message, yours or someone else's, can become the description of a new ticket:
- Hover over the message, and select More options.
- Among the actions of your apps, select New ticket in Alloy Navigator. The ticket form opens with the message text in Description.
- Add a summary, edit the description if needed, and select OK.
What the assistant can help you with
A new 2026.1 database created with the Default Workflow (see Default Workflow Configuration) contains a configuration record for the bot. The record names four of the Self Service Portal's own actions for the bot to use, in two groups:
- Ticket commands: New Technical Issue (Self Service Portal), for creating a ticket, and Update Incident (Self Service Portal), for updating one.
- Approval commands: Approve Request (Self Service Portal) and Reject Request (Self Service Portal), for answering approval requests.
All four actions are enabled in the supplied configuration. An upgraded database need not contain this record, and an administrator may have changed it.
The bot itself decides how the forms of these actions appear in Microsoft Teams. The sections below describe what the supplied configuration puts on each form.
Report a technical issue
The New Technical Issue (Self Service Portal) action has a form captioned Report a Technical Issue, with the instruction "Please fill in the following fields." Its fields, in this order, are:
- Summary - mandatory.
- Description - mandatory.
- A category - optional.
- An urgency - mandatory, with an initial value.
- An impact - mandatory, with an initial value.
- Collaborators - optional; you can select several active people.
- Related to - optional; you can select one of the physical configuration items whose owner is you.
Because urgency and impact start with initial values, the form is complete once Summary and Description are filled in.
The action records and publishes the activity New Technical Issue was created, and the configuration item you select in Related to becomes the ticket's related configuration item.
Add a comment to a ticket
The Update Incident (Self Service Portal) action has a form captioned Add a Comment, with the instruction "Please provide a comment." Its fields are:
- Comment - mandatory, formatted text.
- End Collaboration - a yes-or-no field. Its hint says that if you end collaboration, you will no longer receive notifications about the ticket, be able to update it, or see it in your Self Service Portal.
- Mark Closed - a yes-or-no field. Its hint says that marking the ticket closed indicates that you either want to cancel the ticket or confirm that it is resolved and you no longer need assistance.
The action adds your comment to the details of an activity named A comment was added via Self Service Portal and publishes that activity.
Approve or reject a request
The Approve Request (Self Service Portal) action has a form captioned Approve Request, and the Reject Request (Self Service Portal) action has a form captioned Reject Request. Each form has one field, Comment, which is mandatory and holds formatted text. On the Approve Request form, the comment has the initial value "I approve this request" in the supplied configuration.
When a command is not available
An administrator can switch off the ticket commands or the approval commands as a group, or each of the four actions on its own. The configuration also holds a message for each group and each action, for when that group or action is off. In the supplied configuration:
- The message for the ticket commands says that ticket commands are not available and asks you to visit the Self Service Portal instead.
- The message for the approval commands is "Approval commands are not available."
- The message for each single action is "This command is not available."
Related topics
- Microsoft Teams: Self-Service Assistant Bot - how the assistant is added and configured.
- About the Self Service Portal - the portal whose actions the assistant uses.
- Default Workflow Configuration - the supplied configuration that a new database can be created with.