Initialize Alloy Navigator bot in Teams

Introduced in 8.7.3

This article shows how to initialize the Alloy Navigator bot in Teams. Initialization is the first thing that must be done, it happens only once. Since the initialization step includes publishing the app and obtaining access tokens, it must be performed by a Microsoft 365 administrator.

  1. Publish the bot app to your org.

  2. Initialize the Alloy Navigator bot in a private conversation with the bot.

Publish the bot app to your org

The Alloy Navigator bot is a Microsoft-certified app published to the Microsoft Teams store. To make the bot available to other employees, you may need to publish it for your organization, so your people can add it to their Teams. By default, Microsoft Teams allows access to all Microsoft-certified third-party apps. However, there are org-wide settings that could turn some apps off and on.

For information about making apps available to users in your organization, see Manage your apps in the Microsoft Teams admin center. This task requires a Teams Administrator role for your org.

NOTE: If you cannot find Alloy Navigator in the Microsoft Teams store, please contact our Support Team.

Initialize the Alloy Navigator bot

Add the Alloy Navigator bot to your Teams application and initialize it in a private chat.

  1. In Microsoft Teams, add Alloy Navigator.

    TIP: On the left side of Teams, click Apps, search for Alloy Navigator, and click Add. If you cannot find Alloy Navigator in the Microsoft Teams store, please contact our Support Team.

  2. In a chat with Alloy Navigator, type init.

    The bot will reply with a pair of tokens.

These tokens grant access to a bot configuration for your organization.

  • An access token gives access to the bot configuration. Typically, you send it to an Alloy Navigator administrator who is to configure the bot.

  • A refresh token allows obtaining a new access token if needed. If the access token is lost or compromised, you will need to generate a new one, and that is where you would need the refresh token. Typically, you save the refresh token in a secure location, separately from the access token.

What's next?

Now you can send the access token to an Alloy Navigator administrator, who will use it to configure the Alloy Navigator bot.