--- title: Microsoft Teams Add-In slug: voice-for-microsoft-teams-legacy/microsoft-teams-add-in description: Install and use the Unaric Voice add-in for Microsoft Teams to bring Salesforce calling directly into your Teams workspace. image: https://archbee-image-uploads.s3.amazonaws.com/10Nod6Ww95R3dPr0k0TCJ/nbDK4MN47GJLCChKS2ycv_unaric-voice-for-microsoft-teams-11111.png icon: {"faIcon":"fa-brands fa-microsoft"} docTags: createdAt: 2025-07-30T02:36:30.324Z --- The **Unaric Voice app for MS-Teams **connects Microsoft Teams with Salesforce so you can log calls even when not logged in to Salesforce. Each call is automatically logged as a Task with call details on the related Salesforce contact. This setup is ideal for using the MS-Teams app in combination with Salesforce while working on the go. The **Unaric Voice MS-Teams Add-In** is available for: - Microsoft Teams desktop app - Microsoft Teams in the browser - Microsoft Teams mobile app (Android and iOS) ## Interface ::::VerticalSplit{layout="middle"} :::VerticalSplitItem **Desktop** ![](https://helpserver.biz/onlinehelp/cdc/sf/5.0/help2000/images/teams-add-in-desktop-start-screen.png) ::: :::VerticalSplitItem **Mobile** ![](https://helpserver.biz/onlinehelp/cdc/sf/5.0/help2000/images/teams-add-in-mobile-start-screen.png) ::: :::: ## Prerequisites Before users can use the **Unaric Voice MS-Teams Add-In**, ensure that: - [ ] The **Unaric Voice MS-Teams Add-In** has been added to Microsoft Teams. - [ ] The user is part of a Teams setup (must be added as a **Call Center User**). - [ ] The MS-Teams Premium licence is active in the Salesforce org. If no valid licence is found in the Teams Add-In configuration, the fields will be disabled and the **Save** button will be hidden. - [ ] The **Enable MS-Teams Add-In** checkbox is selected in the Add-In configuration (see below). - [ ] The **Scheduler for the Unaric MS-Teams Connector** is active (details below). - [ ] The **Presence State User Logout Check** is enabled (details below). - [ ] If you want to log calls as Salesforce tasks or use caller name lookup, the ACD (Automatic Call Distribution) package must be configured. ### Configure MS-Teams Add-In :::hint{type="warning"} If no valid licence is found in the Teams Add-In configuration, modifing fields will be disabled and the **Save** button will be hidden. ::: You can find the **Mirage Configuration - MS-Teams Add-In** in Salesforce as a separate tab (custom object). This setup is linked via a lookup field from the **Phone System Setup**. ![](https://helpserver.biz/onlinehelp/cdc/sf/5.0/help2000/images/teams-add-in-config.png) | **Field** | **Description** | | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Internal name of the Add-In configuration record. Example: *Mirage MS-Teams Connector – Teams Add-In*. | | **Enable MS-Teams Add-In** | Activates the Add-In for this setup. **Must be enabled for any Teams-related functionality to work.** | | **Show Option: Do not Save** | Displays a checkbox in the Unaric Voice Teams app, allowing users to opt out of logging individual calls in Salesforce. | | **URL to Save Calls into Salesforce** | Created via *Mirage ACD Setup > Create Activities*. Replace *\* with the PBX token before saving. | | **URL to Lookup Caller Details** | Endpoint used to look up caller names or related info. Created via *Mirage ACD Setup > Data Lookup*. Also requires replacing *\*. | | **Automatically create an activity at the end of a call for**
| Specifies for which call types an activity should be automatically created after a call ends.
This setting also controls the visibility of the checkbox “Do not log the Call in Salesforce” in the Add-In.
Available options:
- Incoming call
- Outgoing call
- Internal call | | **Automatically create an activity for unsuccessful / unanswered calls** | Allows automatic activity creation for calls that were not successfully connected. Available options:
- Missed call (inbound)
- Unanswered call (outbound) | | **Configuration for Phone Book Search** | Select a record from **Unaric Cloud Service for Salesforce – Setup** (restricted to the record type **Unaric Voice & Meeting – MS-Teams Setup**). This record defines how phone numbers are searched and matched in Salesforce.
Validations:
- Unaric Cloud Service for Salesforce must be installed and active.
- A valid record must be selected.
- The selected record must contain a PBX Token. | :::hint{type="warning"} Both URL fields (URL to Save Calls into Salesforce and URL to Lookup Caller Details) must start with `https://`. If not, a red validation error will appear, and the save will be blocked. ::: :::hint{type="warning"} If either MS Teams Login Scheduler or Presence state user logout check are deactivated, a red error message with a link to the configuration page is displayed. You must fix these before saving. ::Image[]{src="https://helpserver.biz/onlinehelp/cdc/sf/5.0/help2000/images/teams-add-in-presence-state-error.png" size="72" width="578" height="166" darkWidth="578" darkHeight="166" position="center" showCaption="false"} ::: ### MS Teams login scheduler This scheduled job periodically updates the Teams Add-In configuration for all users. Without this scheduler running, changes in Salesforce won’t be pushed to the Unaric Voice app, and users may remain with outdated settings. :::hint{type="success"} Run the scheduler every 15 minutes to apply updates often but without overloading the system. ::: ### Presence state user logout check This setting ensures that if a user logs out of Salesforce while using the Teams add-in, the add-in itself takes over call logging. For this to work, the Salesforce **logout event stream** must be enabled in the org. If this check is not active: - Calls may fail to be logged after the user logs out of Salesforce. - The Add-In won’t “know” to take over logging duties. :::hint{type="warning"} Salesforce does **not** send a logout event if the session times out automatically — so this feature won’t trigger in that case. ::: :::hint{type="success"} If a user wants to stay logged into Salesforce but stop receiving calls, they should switch their Salesforce softphone presence state to *Logout*. ::: ## Desktop installation 1. Open the [Microsoft Teams Admin Center](https://admin.teams.microsoft.com/) and sign in with admin credentials. 2. In the left panel, navigate to** Teams apps > Manage apps**. 3. Click **Actions** and select **Upload new app **from the dropdown menu. ::Image[]{src="https://helpserver.biz/onlinehelp/cdc/sf/5.0/help2000/images/ms-teams_admin_center.png" size="64" width="1024" height="471" darkWidth="1024" darkHeight="471" position="center" showCaption="false"} 4. Select and upload the Unaric Voice App zip file. 5. After uploading, you can make this app available to everyone or specific members of the group. To check availability, select the **Users and groups **tab. ::Image[]{src="https://helpserver.biz/onlinehelp/cdc/sf/5.0/help2000/images/ms-teams_admin_center_unaric_voice.png" size="92" width="1024" height="473" darkWidth="1024" darkHeight="473" position="center" showCaption="false"} 6. Click **Available to**, then click on **Edit Availability** to select specific users or groups. Click **Apply** to save changes. 7. To open the app, open the Microsoft Teams client (desktop or web or mobile phone), click on the **Apps** tab in the left panel, and search for **Unaric Voice**. ::Image[]{src="https://helpserver.biz/onlinehelp/cdc/sf/5.0/help2000/images/teams-add-in_add_to_teams.png" size="66" width="1024" height="475" darkWidth="1024" darkHeight="475" position="center" showCaption="false"} ### Add Unaric Voice Add-In to Mobile MS Teams app Once installed, you can add the Unaric Voice add-in to the Microsoft Teams mobile app. 1. On the Microsoft Teams mobile app, click the **More** button (three dots) in the bottom menu bar. ::Image[]{src="https://helpserver.biz/onlinehelp/cdc/sf/5.0/help2000/images/teams-add-in-add-to-mobile.png" size="44" width="432" height="529" darkWidth="432" darkHeight="529" position="center" showCaption="false"} 2. Click the **+** icon to add apps. 3. Search for the** Unaric Voice** app and click **Add**. The Unaric Voice app will now be added to your Teams mobile client. ## Sandbox installation The Unaric Voice MS-Teams Add-In can be configured for a Salesforce Sandbox org. This configuration requires a special configuration of the Unaric Voice scheduler, the service in charge of background tasks, to work properly. **Reach out to support for assistance on this setup.** :::hint{type="danger"} Enabling the scheduler in both production and sandbox orgs without separate configuration (especially if both connect to the same Teams tenant) can result in a variety of errors, including missing calls, incorrect logging, and inconsistent behaviour while using the app. :::