TimeZest's Microsoft Teams integration gives it the ability to automatically schedule a Teams online meeting when a client schedules an appointment with TimeZest. This guide will show you how to set it up.

The Microsoft Teams integration uses a beta API which Microsoft hasn't fully released yet. This doesn't affect its functionality or reliability, but there is a risk that Microsoft may discontinue the API call we use, and the TimeZest integration will no longer be able to function. But, unless and until that happens, it's fine for you to use.

Update your email templates

If you've set up any custom HTML email templates for your organisation, you'll need to add some additional content to them so that TimeZest can include the information the client will need to join the scheduled online meeting.

Simply add something like the following in the appropriate place for your template:

{% if appointment.online_meeting_url %}
<p>
This {{ appointment_type.name }} will take place as an online meeting.
</p>
<p>
You can access this online meeting here:
<a href="{{ appointment.online_meeting_url }}">{{ appointment.online_meeting_url }}</a>.
</p>
{% endif %}

TimeZest's built-in templates have already been updated, so you don't need to do anything if you're using them.

Adding the Integration

To connect TimeZest with Microsoft Teams, go to the Integrations page in the TimeZest UI. Click on the Microsoft Teams integration.

To authenticate, the TimeZest integration will need to be approved by an Office 365 global admin, as it is an account-level application rather than a user-level one.

Click the Authenticate with Microsoft Teams button, then follow the Office 365 prompts to approve the application. You'll be returned to the integration page.

Don't be concerned if all members are shown as not associated with a Teams user account. In the background, TimeZest is querying Office 365 in order to match users there with the members in TimeZest, using their email address as a matching key. After a minute or so, you can refresh the screen to see which members have been matched.

Configuring Appointment Types for Microsoft Teams

To configure TimeZest to create a Teams online meeting for a particular appointment type, simply go to that appointment type in the Appointment Types screen, and select the Online Meetings section. Select Schedule a Microsoft Teams online meeting with this appointment, and click Save & Close. That's it.

Scheduling with Microsoft Teams

In the TimeZest pod, meetings with online meetings will have a small camera icon next to them in the drop-down list.

TimeZest will also warn you if you try to schedule a meeting with an appointment type which has a Microsoft Teams meeting, but the scheduled member doesn't have an account:

Did this answer your question?