Skip to main content
Skip table of contents

Installing Sofie on Microsoft Teams

Read this article in: Deutsch

For information on how to use Sofie and its various features, check out Sofie - Rapid Awareness & Zero Level Support

Prerequisites

Before installing Sofie, ensure you have:

  • Microsoft Tenant ID: Required to connect Sofie to your MS Teams environment. Your MS Teams admin can help retrieve this.

  • Custom App Installation Enabled: Your MS Teams admin must allow installation of custom apps.

Installation Steps

Configure Sofie in the SoSafe Manager

  1. Go to: SoSafe Manager → Sofie → Zero Level Support / Rapid Awareness → Bot Configuration

  2. Enter your Microsoft Tenant ID

  3. [Optional] Customize your bot or the welcome message

  4. Click Save

  5. Download the manifest file (ZIP)

    image-20250317-142903.png

Upload Sofie as a custom app in MS Teams

  1. Go to: Microsoft Teams Admin Center → Teams apps → Manage apps

  2. Click Upload new app

  3. Select Upload a custom app

  4. In the dialog, click Upload and select the manifest ZIP file downloaded in step Configure Sofie in the SoSafe Manager

image-20250317-142920.png
image-20250317-143022.png

Assign Sofie to users via setup policies

  1. Go to: Microsoft Teams Admin Center → Teams apps → Setup policies

  2. Choose whether to edit an existing policy or create a new one. To create a new policy:
    Click Add, name the policy, and proceed to the next step.

  3. Add Sofie as an installed app to the selected policy

  4. Assign users to the policy:

    • Select Manage users and assign users or groups to the policy.

    • We recommend applying one organization-wide policy to include all users.

    • If you want to test Sofie with a smaller group first (e.g. IT department), create a separate policy with limited user access.

Note: A welcome message will be automatically sent to all users assigned to this policy.

image-20250317-143043.png
image-20250317-143103.png

Monitor installation progress

Once Sofie is deployed, the SoSafe Manager will display a rollout progress indicator, showing:

  • Total number of users provisioned with Sofie.

  • Comparison between provisioned users and total enabled employees.

This helps track the progress and effectiveness of the rollout.

Note: The installation can take up to 24 hours to complete for all users. This delay is due to Microsoft’s provisioning process and cannot be influenced by SoSafe.

image-20250317-143212.png

Uninstalling Sofie

To remove Sofie from Microsoft Teams:

  1. Go to: Microsoft Teams Admin Center → Teams apps → Manage apps

  2. Find the Sofie app and click the three dots menu (⋮)

  3. Select Actions and then Delete

    image-20250317-143238.png

Troubleshooting installation issues

If users do not see Sofie in their Teams environment, ask them to:

  1. Go to Apps in the left Teams navigation menu.

  2. Search for Sofie in the app directory.

  3. Click Add to install Sofie manually.

  4. Sofie will now appear in their Teams sidebar and send a welcome message upon first use.

You need further assistance?
Check out our other support articles or contact your Customer Success representative - we’re happy to assist!

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.