Overview of Teams permissions and availability

OneBot enables you to configure how it should interpret your users’ availability status for some actions. Authorise your Teams configuration using your Azure Tenant ID to enable OneBot to filter your users based on their availability.

Understand Teams permissions and availability

In some cases, you may want to streamline a quick response to customer questions or perhaps ensure an urgent task is handled in a timely manner. In these cases, being able to filter users based on their available status can be helpful. Certain OneBot actions are designed to use permissions to incorporate this feature, filtering a list of users based on their current status and the Available Status Values you set in the Teams configuration.

Only certain actions are designed to behave this way. In general, OneBot doesn’t consider the ‘available status’ of users before sending messages. OneBot actions that do filter users based on their available status include:

• Check user is available

• Check users are available

• Filter available users

OneBot needs to be given permission to access information on the availability of your users. You do this by adding your Azure Tenant ID to the Teams configuration and completing authentication using Microsoft’s authentication service.

Set up and manage Teams permissions

Grant permission for your OneBot Teams configuration to access information on the available status of your users. You can set up multiple Teams configurations, each with their own authorisation and Available Status Values.

Locate permissions in the Teams configuration

Navigate to the permissions for a Teams Chat Client configuration:

1. Click 'Chat Clients' in the navigation bar of the OneBot console.

2. Click ‘Configure’ on Microsoft Teams to open the manager for your Teams configurations.

3. Click on the configuration you want to work on to open it.

4. Ensure you are viewing the ‘Settings’ tab.

5. Scroll toward the lower half of the page to view the permissions settings.

Authorise access to available status information

Authorise your Teams configuration by authenticating your Azure Tenant ID using Microsoft’s authentication service:

1. Locate the Permissions section of the Teams configuration page (see above).

2. Set the ‘Directory ID’ field to match your Azure Tenant ID.

3. Click ‘Authorise’. Your browser will redirect to Microsoft’s authentication service: use this to authorise Azure to provide user availability information.

4. Ensure your Azure Tenant ID remains set as the ‘Directory ID’ in the Teams configuration: if the browser navigates away from the configuration page during authentication, you may need to re-enter the ID now.

5. Click ‘Save’ to complete the authorisation.

To configure how OneBot handles the available status of your Teams users, see the section Configure available status values below.

Deauthorise access to available status information

Remove the authorisation for your Teams configuration to access user availability status information:

1. Navigate to Permissions in your Teams configuration (see above).

2. Click ‘Deauthorize’.

3. Click ‘Save’.

Edit Teams permissions and availability

Configure available status values

Set the available statuses that OneBot should use to filter users. For certain actions, OneBot treats users as being ‘available’ only if their available status matches one of the values you select as part of your Teams configuration.

1. Navigate to Permissions in your Teams configuration (see above).

2. Check each ‘available status’ OneBot should select as an ‘available’ user.

3. Click ‘Save’ to complete the configuration.

v3.0