In this article
Objective
Enable employees to generate unique Microsoft® Teams video links for video appointments to be used in the Client View, Schedule, or Contact Center areas of Coconut.
NOTE: Microsoft® Teams integration is an optional add-on. Please connect with your Customer Success Manager to get started.
Steps
Connecting Microsoft® Teams with Coconut requires setting up the integration, enabling it for users, and ensuring services are set up to include video calls as a meeting method.
Set up the integration
From the navigation menu, click Settings
From Integrations & API, click Video Calls
Click Microsoft Teams
Select which field in Coconut contains your Microsoft Universal Principal Name (UPN); this is most often staff’s email addresses
NOTE: For more information on UPNs, please refer to this article
Hot Tip! Ensure staff’s email addresses in Coconut are the same email addresses that are used to sign in to their Microsoft accounts for a seamless experience for your employees
Click Continue
Enter your Microsoft Tenant ID
NOTE: For more information on how to find your tenant ID, please refer to this article
Hot Tip! The service account (email address) associated with the tenant ID used to complete the integration will appear as a participant in all meetings created using the integration. Create a generic service account and use that account’s tenant ID to set up the integration if you want to keep your existing service account details private.
Click Continue
Review the permissions request details and click Accept to proceed with the integration
Coconut will refresh and a success message displays.
NOTE: Settings>Video Calls will display Microsoft Teams in parentheses if the integration was successful.
Enable the integration for users
A list of users displays in Video Calls. The account used to establish the integration displays at the top of the screen.
To enable/disable the Teams integration for a user:
Navigate to the user that requires changes
Toggle on/off the Video Calls setting for that user, based on the required change
NOTE: A checkmark in the Microsoft Teams User column indicates that user’s Coconut and Teams accounts are successfully synced.
Once the integration is configured, it can be enabled for users from the Video Calls page
Hot Tips!
To make a mass update of all users, select the checkbox preceding the Coconut User heading
To modify the sort order, click the arrow icon following the Coconut User heading
To find a specific user, enter the user’s details in the search bar
To filter the list based on whether the integration is enabled or whether the user in Coconut is a match for the Teams user, click the Filter list icon
To increase the number of display results, navigate to the bottom of the user list, select the Rows per page drop down, and make your desired changes
Modify the video service provider for a staff member
When a video integration is enabled for the first time, it becomes the default video service provider for staff facilitating video appointments. If the default requires changing, you will need to modify the video service provider for the staff member.
To modify the video service provider for a staff member:
From the navigation menu, click Staff
Navigate to the staff member you want to modify
Click Profile
From the Video Calls Platform dropdown, select your preferred option
Click Save
Set services to include video calls
Services that will include the option to join by Teams link will require that video calls is an optional meeting method. To set a service to include video calls:
From the navigation menu, click Services
Navigate to the service that will include video calls as an option
Click More
From Meeting Method, select Video Call
Click Save
Refresh the integration
Updates made to the UPN through Microsoft® Teams or other Microsoft apps will require a manual refresh of the integration.
To perform a manual refresh:
From the navigation menu, click Settings
Click Video Calls
Click Refresh
Click Refresh once more to confirm
You are returned to the Video Calls screen, where a confirmation displays once the refresh successfully completes.
What is automatically synced?
Coconut automatically refreshes the sync when:
A new staff member is added to Coconut
A staff member’s email or username is updated
A staff member is assigned to a service
Disconnect the integration
To disconnect the integration:
From the navigation menu, click Settings
Click Video Calls
Click Disconnect
Click Disconnect once more to confirm
NOTE: Disconnecting the integration does not impact previously scheduled appointments that included a Teams video call link.
A note on access and visibility
Admins can connect the Microsoft® Teams integration by accessing Settings.
For troubleshooting information, please refer to Microsoft® Teams Integration: FAQ