Use Alloy Navigator bot in Teams
Introduced in 8.7.3
This page describes how use the Alloy Navigator bot to communicate with Alloy Navigator Express in your Microsoft Teams app. See how to add the bot, where to use it, what you can do with the bot, and what Alloy Navigator Express objects you can access in Teams.
At first, you may need to add the Alloy Navigator bot to Microsoft Teams before you can use it. If you don't see the Alloy Navigator bot app in the left pane, click the ellipsis button (More added apps), and then select Alloy Navigator.
The bot follows your commands. The first scenario is when you send commands in a private chat with the bot, and the bot replies to your commands by messaging you back. The other scenario is when you communicate with the bot without navigating away from a conversation with somebody else or create tickets from somebody's Teams messages. In that case, the bot replies in pop-ups.
IMPORTANT: In any scenario, only you can see what the bot replies.
To send a command to Alloy Navigator in a one-to-one conversation with the bot, hover over the compose message box to reveal the What can I do? menu and choose a command from the menu. Alternatively, type a command into the message box.
To add Alloy Navigator to all your chats and channels, use a messaging extension. This is the Alloy Navigator icon at the bottom of your Teams window. If you don't see that icon, click the ellipsis button (Messaging extensions) at the bottom, find Alloy Navigator, and pin it. Then you can send commands to Alloy Navigator when chatting with other people, and the bot will reply in pop-ups.
NOTE: An example of using the Alloy Navigator extension is when you need to mention a ticket you once created but cannot remember the details. Tell Alloy Navigator to list your tickets, and you will quickly find the right one. Another example is when you search the knowledge base to find a ready-to-use solution and then proudly paste it into your chat.
You can use the bot to quickly create a ticket based on somebody's (or yours) message. The message text will become a ticket description, and all you will have to do is polish it and add a summary. For details, see Create tickets.
Whether in a private chat with Alloy Navigator or when chatting with other people, you can ask the bot to do these tasks for you:
List your tickets so you can quickly locate a specific one and update it or drill down to its details.
Create tickets to report issues immediately.
View a ticket by its number to get into what's going on with the issue you have reported and optionally update it.
List your approvals, so you can view all requests pending your approval and take action right now.
Search the knowledge base to quickly find how-tos and ready-to-use solutions.
View an article by its ID to view the contents of the knowledge base article whose ID you happen to know.
INFO: For a complete list of bot commands and their short forms, see Reference: Alloy Navigator bot commands.
NOTE: To let the bot identify you, it is required that you have a Person record in Alloy Navigator Express, and the email address in that record matches the email address in your Microsoft Teams or Microsoft 365 account. Otherwise, the bot will throw an error message. If an error occurs, contact your Alloy Navigator Express administrator.
To list all your open tickets, use the list tickets command.
To see the details of a ticket, click View Details. The bot will open the ticket details, as shown in View a ticket by its number, and prompt you to update it or view its history.
You can create new tickets from scratch or create them from Teams messages.
To create a new ticket from scratch:
Use the new ticket command to bring out a short form.
Specify a ticket summary and description, and click OK.
To create a ticket from a message in Teams:
Hover over a message to reveal a bar with quick reactions at the top of the message.
Click the ellipsis button (More options), and then select More actions > new ticket. A ticket creation form opens up, with the message text in the Description field.
Add a summary and optionally edit the description, and click OK.
As the bot creates a new ticket, it will send you its number. You can click that number to open your ticket on the Self Service Portal.
To view the details of a ticket by its number, use the ticket command and specify a ticket number.
To update the ticket with your comment, click Update. To see the history of ticket updates, click History.
To list all requests pending your approval, use the list approvals command.
To approve or reject a request, click Approve or Reject, provide a comment, and click OK.
If you want to see the request details before deciding anything, click View Details, and then pass your verdict on the request details form.
To search the knowledge base, use the search articles command and type in the text to search for. The bot will find all the articles that contain your text.
To see the content of an article, click Details.
To view the content of a knowledge base article by its ID, use the article command and specify an article ID.
The Alloy Navigator bot mimics the Self Service Portal behavior for regular users, which means that it gives you access to these Alloy Navigator Express objects:
Your own open tickets. You can view non-closed
Ticketsthat you have created yourself.
Approval requests pending your approval. You can work with those Approval Requests that are assigned to you and have a "Pending" status.
Public Knowledge Base articles. You have access to public Knowledge Base Articles with a "Live" status.