Exchange 2007*

Exchange 2010*

Prerequisites

In order to successfully integrate an Exchange 2010 calendar, you’ll need to fulfill a few requirements as listed below: 

• Have admin access within your Exchange 2010 server.
  Note: If you’re using a hosted provider you may need to reach out to your provider for more details.

• A valid Exchange Web Services (EWS) Endpoint that’s publicly accessible. An example would be https://mail.yourdomain.com/ews/exchange.asmx - Reach out to your Exchange administrator to get this information.

Ports for Teem Setup

Now that the prerequisites are complete, you’re ready to set up and use the Exchange 2010 Calendar sync. Let’s start with ports. With some security setups, firewalls can still pose an issue with communication. Teem needs inbound connection open from your Exchange server to the following IP addresses (port 443):

• 54.244.248.254

We’ve also created two dedicated IP addresses to accept push notifications from Exchange, which will allow us to update your devices as soon as events are created or changed. Teem needs outbound connections open from your Exchange server to the following IP addresses (port 443): 

• 104.16.52.95
• 104.16.53.95

If there are multiple firewalls in your organization, it may need to be added in multiple places. 

Create a User Account for Teem to access with the server

Next, you need to create a user account for Teem to access the server. To do this, sign in to your Exchange server and open the Exchange Management Console.

1. Go to Recipient Configuration.

2. Select Mailbox.

3. Then select New Mailbox.

4. You will then select the User Mailbox option.

5. Click Next.

6. From there, you’ll fill in the User Information fields. We suggest creating an email that is easily recognizable like teem@domain.com.

7. Ensure everything is correct and continue by clicking Next.

8. Verify the information on the Configuration Summary and click Next.

9. Click Finalize on the last setup page.

You have now created a mailbox for our server to utilize. If you’d like more detailed instructions on how to create a user, or a list of PowerShell commands, refer to Microsoft’s help article here.

Create or locate room resources for Teem to interface with.

In the same Recipient Configuration/Mailbox list is the management console. You’ll be able to see Room Mailboxes as well as User Mailboxes. If the Room Resource you need isn’t listed there, select the New Mailbox option, just like we did in user creation. This time you’ll select Room Mailbox and proceed exactly as before. If it’s listed, skip ahead to the next step.

If you’d like more detailed instructions on how to create a room, or a list of PowerShell commands, refer to Microsoft’s help article here.

Configure Room Resource Properties

Next, you need to change some settings on the room resource account’s Room Properties that will make the sharing of information between servers more complete.
Note: You’ll need to do this for each room with a room display that you want to display current and upcoming meeting information.

1. On the Resource General tab, make sure that the Resource Booking Attendant is enabled.

2. Then, on the Resource Information tab (to make events on EventBoard show more information) uncheck Delete the subject. Also, if you’d like private meetings to work on the EventBoard, you may want to uncheck Remove the Private Flag. After all, Bob's birthday only comes once a year, and it should be a surprise.

Permission the Teem user account to control these room resources.

There are two ways to access a mailbox: delegate and impersonation access. Delegate access acts on behalf of an authorized user with that user’s explicit permission. Impersonation allows the service account to manage events on behalf of your office’s room resources calendars, regardless of who originally created the event.

Choose which method works best for you, delegate or impersonation access and proceed accordingly.

Note: The End Event Early function still requires complete impersonation access to all mailboxes. 

Delegate Access*

If you’re looking for a more secure method to control these rooms, our Teem user account needs to be set as a ‘delegate’. Set the permissions as a delegate:

1. Click on your room resource mailbox from the Exchange Management Console

2. Go to Manage Full Access Permission on the right side of the console.

3. A new window will pop up. Click +Add and find your management account.

4. Click Okay.

5. Click Manage.

6. Click on Finish.

You have now set the room resource to have delegate permissions.

If you’d like more detailed instructions on how to grant Full Access Delegation on behalf of a room, or a list of PowerShell commands, refer to Microsoft’s help article here.

Impersonation*

Please ensure that you have fulfilled the requirements listed below before setting up Impersonation:

• Have administrator access to your on-premises Exchange server.
  Note: if you are a hosted Exchange customer, you must use delegate access because hosted providers do not allow access to PowerShell on the server to complete the needed steps.

• Have a Teem account with administrator permissions.

• Have access to the Exchange Management Shell with admin access.
   

Next, decide what approach you want to take: configure impersonation for all accounts, or configure only for specific user groups.

Here are PowerShell instructions on setting Impersonation up in any Exchange environment.
 

Configure Impersonation for All Service Accounts in Your Organization

Using Exchange Management Shell, run this command: 

New-ManagementRoleAssignment -Role:ApplicationImpersonation -User:username

You’ll need to change the “username” section to your specific service account name for this to work.

Configure Impersonation for Specific Service Accounts
By restricting the access or scope, Teem can be granted access to only room or equipment calendars.

Using Exchange Management Shell, run this command:

New-ManagementScope -Name "ResourceMailboxes" -RecipientRestrictionFilter {RecipientTypeDetails -eq "RoomMailbox" -or RecipientTypeDetails -eq "EquipmentMailbox"}

Now that you’ve created this new scope for Impersonation, we need to assign the Impersonation role to the service account using this command:

New-ManagementRoleAssignment –Name "ResourceImpersonation" –Role ApplicationImpersonation –User "username" –CustomRecipientWriteScope "ResourceMailboxes"

Connecting Exchange to your Teem Account

Good job! Now that you’ve set up access, you’re ready to connect an Exchange account to your Teem account.

1. Sign in to your Teem account.

2. Go to the Manage section in the left menu.

3. Click Calendars.

4. Look to the upper left corner and choose the + Account button.

5. Select Exchange.

6. After you choose Exchange, there will be a screen where you’ll need to enter your information in order for us to import your calendars. Enter your Exchange login and password.

For instance, if the email address is will@teem.com, but the Active Directory login domain is teem.local, will@teem.local would be input into this field.

7. Select the version of Exchange that your company uses (2010).

8. Enter your EWS endpoint. (If you don’t see the EWS Endpoint field, uncheck the Use Auto Discovery box, and it will appear.)

9. Select delegate or impersonation access.

10. Click the Authenticate button at the bottom.

If you get an error message such as “Unauthorized” or “internal screenshot default Server” error, the account is added into our system, but the account is considered inactive. We recommend you contact technical support at 415-830-6989, and they will assist you in getting your account up and running.

Once the account is added, you’ll need to add your calendars. To do this, you’ll press the yellow Import button within the calendars section and provide a comma-separated list of all calendars that you wish to import to Teem. Alternatively, you can enter calendars to sync via a CSV file.

That’s it! Your Exchange account is now integrated with Teem. You should receive an email directed to the sync account informing you which calendars we’ve synced with.

Now you’re ready to assign your Exchange calendars to rooms.

Exchange 2013*

Prerequisites

In order to successfully integrate an Exchange 2013 calendar, you’ll need to fulfill a few requirements as listed below:

• Have admin access within your Exchange 2013 server.
  Note: If you’re using a hosted provider you may need to reach out to your provider for more details.

• A valid EWS (Exchange Web Services) Endpoint that’s publicly accessible. An example would be https://mail.yourdomain.com/ews/exchange.asmx - Reach out to your Exchange administrator to get this information!

Got all that? Now you’re ready to set up and use your Exchange calendar sync!

Ports for Teem Setup

Now that the prerequisites are complete, you’re ready to set up and use the Exchange 2013 Calendar sync. Let’s start with ports. With some security setups, firewalls can still pose an issue with communication. Teem needs inbound connection open from your Exchange server to the following IP addresses (port 443):

• 54.244.248.254

In addition, we have created two dedicated IP addresses to accept push notifications from Exchange, which will allow us to update your devices as soon as events are created or changed. Teem needs outbound connections open from your Exchange server to the following IP addresses (port 443): 

• 104.16.52.95
• 104.16.53.95

If there are multiple firewalls in your organization, it may need to be added in multiple places. 

Create a User Account

The first step in creating the User account is to sign in to your Exchange server and open Exchange Management Center.

1. Go to Recipients.

2. Select Mailboxes.

3. Then click the + icon.

4. From there, you’ll fill in the New User Mailbox information fields. We suggest creating an email that is easily recognizable like teem@domain.com.

5. Ensure everything is correct and click Save.

You have now created a mailbox for our server to utilize.

Creating or Locating Room Resources

If you already have Room Resources created, you can skip this step. If not, you’ll need to go to Exchange Management Center.

1. Go to Recipients.

2. Select Mailboxes.

3. Then click the + icon.

4. From there, you’ll fill in the New Room Mailbox information fields.

5. Ensure everything is correct and click Save.

You have now created a room resource mailbox.

If you’d like more detailed instructions on how to create a room, or a list of PowerShell commands, refer to Microsoft’s help articles for Exchange 2013.
 

Granting Permission to Administer Room Resources

There are two ways to access a mailbox: delegate and impersonation access. Delegate access acts on behalf of an authorized user with that user’s explicit permission. Impersonation allows the service account to manage events on behalf of your office’s room resources calendars, regardless of who originally created the event.

Choose which method works best for you, delegate or impersonation access and proceed accordingly.

Delegate Access*

If you are looking for a more secure method to control these rooms, our Teem user account needs to be set as a delegate and an editor. To set the permissions as a delegate you will go to the Exchange Management Center and click Recipients, Resources, and double-click on the room resource. In the room detail pop-up, click on Mailbox Delegation.

In that delegation window, scroll to the bottom and find the Full Access section. Here, you’ll click the + icon. In the next pop-up, click +Add and find your management account and click Okay. Verify it has been added and click Save.

If you’d like more detailed instructions on how to grant Full Access Delegation on behalf of a room, or a list of PowerShell commands, refer to Microsoft’s help articles for Exchange 2013.

Now that the user is assigned as a Full Access Delegate, log in to the Outlook Web App using that user's credentials. Open that user’s calendar. On the top navigation, select the user account's drop down menu. Now select Open another mailbox.

This will open a pop-up dialog window. In the input field, type or paste in the email address for the shared calendar or resource you would like to integrate with Teem. If it doesn't come up immediately, you may need to click Search Contacts & Directory. In this example, the resource calendar is called Wiggins. After selecting the appropriate calendar, click Open on the pop-up.

This will open a new window in your browser with you logged into the Room Resource's account. In the top navigation, select Calendar.

After doing this, you will see a Share option at the top right of the page (next to the print icon).Click on share.

This will open up a Share Calendar dialogue. In the Share With field, type or paste the management account you've set up to use with Teem. If the account doesn't come up as you type it, you may need to select Search Contacts & Directory.

After selecting that management account, you’ll need to give it specific privileges. Teem requires the ability to read/write to calendars, so you must select Editor in this dropdown.

After selecting the permission, press Send in the top of the dialogue window. This will send a share request to the Teem user account.

To accept the request, log back into the Teem user account. Usually, this account will still be open in another browser window/tab from the earlier steps. Once logged in, select Outlook in the top navigation.

You will have a new message from the room resource calendar, inviting you to subscribe to the shared calendar. Select + ADD CALENDAR in the email message.

This will open the calendar tab. You should see the new room resource calendar listed on the left side of the page under Other Calendars. Ensure this calendar is checked.

Note: Calendars added here must appear under Other Calendars. If these calendars are in different sections, we won't be able to discover that calendar.

Repeat this process for each room/calendar that you would like to use with Teem.

Impersonation*

If you’d like to use PowerShell commands and configure Impersonation, please refer to the above article, and use the commands listed there.

To set up Impersonation through the Exchange Management Console, follow these steps:

1. First, click on Permissions, and Admin Roles. Then double-click on Discovery Management.

2. In the Discovery Management detail section, select the + icon over Roles.

3. Click ApplicationImpersonation, then click the Add button below. When that role is added, click Save.

4. Verify that ApplicationImpersonation now appears under Roles, then click the + icon over the Members section.

5. Find the user account we created above in the list, click on it, and select the Add option below. Once you verified the account has been selected, click Save.

6. Back in the Discovery Management detail window, ensure the user name appears in the Members section. If it does, click the Save button.

7. Verify the new role and user appear in the Discover Management role and you are done!

Your listed user now has Impersonation rights.

Connecting Exchange to your Teem Account

Good job! Now that you’ve set up access, you’re ready to connect an Exchange account to your Teem account.

1. Sign in to your Teem account.

2. Go to the Manage section in the left menu.

3. Click Calendars.

4. Look to the upper left corner and choose the + Account button.

5. Select Exchange.

6. After you choose Exchange, you’ll see a screen to enter your information in order for us to import your calendars. Enter your Exchange login and password.

For instance, if the email address is will@teem.com, but the Active Directory login domain is teem.local, will@teem.local would be input into this field.

7. Select the version of Exchange that your company uses. For this article, it’s 2013.

8. Enter your EWS endpoint. (If you don’t see the EWS Endpoint field, uncheck the Use Auto Discovery box, and it will appear.)

9. Select delegate or impersonation access.

10. Click the Authenticate button at the bottom.

If you get an error message such as “Unauthorized” or “internal screenshot default Server” error, the account is added into our system, but the account is considered inactive. We recommend you contact technical support at 415-830-6989, and they will assist you in getting your account up and running.

Once the account is added, you’ll need to add your calendars. To do this, you’ll press the yellow Import button within the calendars section and provide a comma-separated list of all calendars that you wish to import to Teem. Alternatively, you can enter calendars to sync via a CSV file.

That’s it! Your Exchange account is now integrated with Teem. You should receive an email directed to the sync account informing you which calendars we’ve synced with.

Now you’re ready to assign your Exchange calendars to rooms.

Exchange 2016*

Prerequisites

In order to successfully integrate an Exchange 2016 calendar, you’ll need to fulfill a few requirements as listed below:

• Have admin access within your Exchange 2016 server.
  Note: If you’re using a hosted provider you may need to reach out to your provider for more details.

• A valid EWS (Exchange Web Services) Endpoint that’s publicly accessible. An example would be https://mail.yourdomain.com/ews/exchange.asmx - Reach out to your Exchange administrator to get this information!

Got all that? Now you’re ready to set up and use your Exchange calendar sync!

Ports for Teem Setup

Now that the prerequisites are complete, you’re ready to set up and use the Exchange 2016 Calendar sync. Let’s start with ports. With some security setups, firewalls can still pose an issue with communication. Teem needs inbound connection open from your Exchange server to the following IP addresses (port 443):

• 54.244.248.254

In addition, we have created two dedicated IP addresses to accept push notifications from Exchange, which will allow us to update your devices as soon as events are created or changed. Teem needs outbound connections open from your Exchange server to the following IP addresses (port 443): 

• 104.16.52.95
• 104.16.53.95

If there are multiple firewalls in your organization, it may need to be added in multiple places.