Setting Up the Arist Teams Bot
Purpose: Modify (or create) an App Setup Policy in Teams in order to create Learners and Teams Addresses in your integrated Arist Organization.
Follow these steps to setup the Arist Teams Bot for your organization:
Connect Your Teams Tenant to your Arist Organization: Input your organization's Teams Tenant ID into the Arist web platform via Settings > Integrations tab:
Globally allow the Arist Teams App in your Tenant:
You will either do this via the older “Manage apps” and “Permission policies” interfaces if your tenant maintains these
The older “Manage apps” view > Search “Arist” > Ensure “Available to” = “Everyone:
The older “Permission policies” view > add “Arist” to any “Allow specific and block all others” policies, or just ensure that the Global policy “allows all apps”
Or “Manage apps”, https://admin.teams.microsoft.com/policies/manage-apps, if your tenant has migrated to the App centric management interface:
Navigate to Manage Apps > Search “Arist” and select “Edit availability”:
In the Edit availability window, select “Everyone”:
Perform the Arist Teams App Installation via Teams App Setup Policy: In the Teams Admin Center, choose one of the following:
Option 1 (recommended for org-wide access): Add the Arist App to the Global (org-wide default) policy or any existing policy applied to the broad desired subset of users.
Option 2 (for specific users): Create a new Group Policy and assign the Arist Bot to it (instructions), then assign the policy to your organization or a subset of users (instructions).
After the policy update or assignment, Arist will create the Teams Address for each user upon their first activity**, allowing them to receive learning content from Arist.
Note: Users will not receive messages from Arist until enrolled in learning by an administrator.
After the policy update or assignment, Arist will create the Teams Address for each user upon their first activity**, allowing them to receive learning content from Arist.
Note: Users will not receive messages from Arist until enrolled in learning by an administrator.
* Policy update or assignment includes
The addition of the Arist App to an already-assigned Teams App Setup Policy, or
The roll out of a newly-assigned Teams App Setup Policy that includes the Arist App.
** Activity includes
reloading a page, navigating to another page, messaging a colleague, logging out, or logging in to Teams.
Important recommendation:
To ensure a smooth roll-out, install the Teams Bot at least ~1 day per 10K users before launching Arist course(s) to a large group, as the custom policy requires user activity to initiate the user acquisition process (detailed above). For example, for 50K users, it may take about 5 days.
Arist Permissions Provided with this App Policy
When the Arist app is installed for a user, Teams sends an install event notification to Arist. That event includes an id that Arist will use to get the Teams member info. Arist will call
TeamsInfo.getMember(context, [member.id](<http://member.id/>)). The call will returnteams_email,teams_first_name,teams_last_name,conversation.id, and original details from the install event that do not contain any additional identifying information about the user.The Arist Bot will have permission to privately message any user created through this policy without being prompted first by the learner.
Arist will only engage with users for the first time after they are enrolled in a course by an administrator or self-enroll through an Arist Admin-provided URL.
Product Experience
For Arist Admins Delivering Learning over Arist MS Teams Bot
Admins enroll employees in MS Teams courses through the secure Arist Web App for admins (arist.app).
For Employees Learning over MS Teams
Learners will only receive a direct message from the Arist bot when they are enrolled in a course by an administrator. No messages or notifications will be sent upon installation.
Data Security and Privacy
Arist is SOC-2 compliant.
Arist adheres to strict data security and privacy standards, ensuring that all user information is stored securely and accessed only by authorized personnel.
User data is encrypted both in transit and at rest, following industry best practices.
Arist complies with relevant data protection regulations, such as GDPR and CCPA, to protect user privacy.
Regular security audits and penetration testing are conducted to identify and address any potential vulnerabilities.
By implementing this app setup policy and granting the necessary permissions, your organization can leverage the Arist Teams Bot to deliver engaging and effective learning experiences to a broad range of audiences within the company, while maintaining a secure environment.