Sofie Installation Manual
Read this article in different languages: Deutsch
For information on how to use Sofie and its various features, check out Sofie - Rapid Awareness & Zero Level Support
Prerequisites
To set up Sofie, you will need the following
Microsoft Tenant ID: This will be used to connect Sofie to your organization’s MS Teams. Your MS Teams admin will be able to help you with this step.
Allow installation of custom apps in MS Teams: Your MS Teams admin will be able to help you with this step.
To set up Zero Level Support specifically, you should also have the following ready:
Signed beta agreement
Step-by-step guide
In the SoSafe Manager, go to Sofie / Zero Level Support or Sofie / Rapid Awareness (either works) and select the card Bot configuration at the top of the page. Enter your Tenant ID, select Save and then select Download manifest.
In the MS Teams Admin Center, to to Teams apps / Manage apps. Now select Upload new app, followed by Upload a custom app.
In the dialog, select Upload and choose the manifest file (ZIP) you downloaded in the first step.
In the menu on the left, select Setup policies. Here you can either edit an existing policy or create a new one by selecting Add.
In this dialog, name your policy and add Sofie as an installed app.
Still in the policy overview, select Manage users to assign users to the policy you just created.
We recommend having one group policy that contains all users in your organization.
If you wish to initially only send Sofie alerts to a smaller cohort of employees e.g. Only IT employees you can create a policy that contains only users from your IT department (reach out to your IT department if you need help with setting up such a user group).
Important: A welcome message will automatically be sent to all users that are covered by this policy.
![Sofie-Welcome-Message.png](../__attachments/1964015715/Sofie-Welcome-Message.png?inst-v=151b662e-062c-499a-9412-56136710779d)
After the installation is complete, you will start seeing a rollout progress indicator in the Manager. It shows how many end-users have been provisioned with the Sofie app in comparison to all employees enabled in the SoSafe Manager. This will help you assess the progress and effectiveness of the rollout.
![image-20240520-194411.png](../__attachments/1964015715/image-20240520-194411.png?inst-v=151b662e-062c-499a-9412-56136710779d)
![image-20240520-194426.png](../__attachments/1964015715/image-20240520-194426.png?inst-v=151b662e-062c-499a-9412-56136710779d)
![image-20240520-194433.png](../__attachments/1964015715/image-20240520-194433.png?inst-v=151b662e-062c-499a-9412-56136710779d)
![image-20240520-194456.png](../__attachments/1964015715/image-20240520-194456.png?inst-v=151b662e-062c-499a-9412-56136710779d)
![image-20240520-194538.png](../__attachments/1964015715/image-20240520-194538.png?inst-v=151b662e-062c-499a-9412-56136710779d)
It can take up to 48 hours until Sofie is installed for all users. This is a Microsoft limitation that we cannot influence.
Uninstall
In the MS Teams Admin Center, to to Teams apps / Manage apps. Select the Sofie app, followed by the three dots and then select Actions and Delete.
![image-20240520-194011.png](../__attachments/1964015715/image-20240520-194011.png?inst-v=151b662e-062c-499a-9412-56136710779d)
Troubleshooting
If users do not see the Sofie app in their teams, ask them to complete the following steps:
Go to "Apps" on the left navigation.
Search for "Sofie" and click on it.
Click the "Add" button.
Sofie will be added to your Sidebar and greet you with a welcome message.
![image-20240520-194243.png](../__attachments/1964015715/image-20240520-194243.png?inst-v=151b662e-062c-499a-9412-56136710779d)
Open questions? Check out our other support articles or contact your Customer Success representative – they will be more than happy to assist you with any further questions.