{"id":72660,"date":"2022-01-24T12:59:41","date_gmt":"2022-01-24T11:59:41","guid":{"rendered":"https:\/\/officebooking.com\/?post_type=ht_kb&p=72660"},"modified":"2022-08-23T10:25:14","modified_gmt":"2022-08-23T08:25:14","slug":"exchange","status":"publish","type":"ht_kb","link":"https:\/\/officebooking.com\/en\/kb-article\/exchange\/","title":{"rendered":"Microsoft Exchange \u2013 Meeting room sync (on premise)"},"content":{"rendered":"

The Officebooking platform enables you to share your company resources and make them available for booking by your users or employees. We support a number of interaction or touch points for end users including web, mobile and interactive signage solutions. This way your users are supported throughout their complete journey.<\/p>\n

This guide will walk you through the process to set up synchronization with on premise Microsoft Exchange 2013 or Exchange 2016 server installations. Please check our Office 365 integration guide for Office 365 integration only.<\/p>\n

 <\/p>\n

Step 1: Access to OfficeAdmin and\u00a0<\/strong>Exchange<\/strong>\u00a0environment<\/strong><\/h3>\n

This guide assumes someone in your organization (or Officebooking Support) has already created an Admin account for you. This account will give you access to the OfficeAdmin portal.<\/p>\n

Next, you\u2019ll need administrative access to your company Exchange environment. Once you\u2019ve gained access to both environments you can start implementing the integration.<\/p>\n

 <\/p>\n

Step 2: <\/strong>Add resource mailboxes for rooms you want to synchronize (Microsoft admin center)<\/strong><\/h3>\n
    \n
  1. Log in to your Exchange admin center with your Exchange administrator credentials.<\/li>\n
  2. In the main menu, select ‘Recipients’, then select ‘Resources’.<\/li>\n
  3. Select ‘+<\/strong> Add resource’ and enter resource specific information. The minimum required information per room is the name<\/strong> and the email address<\/strong> of the room. Enter the details for example: name = Boardroom I, email address = boardroom369@wilderman.nl, location = Puntegaal (name of your workspace) and room capacity = 8.
    \nPay special attention to the email address of the room. The domain (in our example @wilderman.nl) is already pre filled by Exchange. The part before the @-symbol needs to be unique for the room and is used for synchronization purposes. We use the email address as a unique identifier. Make a note of this unique email address, as you will be required to add this to the Officebooking platform later in the next step. <\/b>Make sure the option ‘Accept or decline booking requests automatically’ is selected.<\/li>\n
  4. After selecting the ‘More options’ button you also have the option to assign a user friendly alias for the room in addition to the more formal name \u201cBoardroom I\u201d. Users will be also able to search in Exchange on this alias.<\/li>\n
  5. Enter the Room mailbox details.<\/li>\n
  6. Save your changes and move to the next step.<\/li>\n<\/ol>\n

     <\/p>\n

    Step 3: <\/strong>Create a new service account<\/strong><\/h3>\n

    You\u2019ll need to have Exchange Web Services (EWS) component available. This is standard for Microsoft Exchange 2013 and most other Exchange versions too. We use EWS to integrate with our Officebooking platform.<\/p>\n

      \n
    1. First step is to create user credentials on your Exchange server to log in to get access to this EWS service. For communication with your server we need to create a Officebooking service user account in your Exchange environment with delegate rights on all resources that need to be synchronized.<\/li>\n
    2. Add a new generic exchange user and give it a name, for example ‘Officebooking Service Account’. Add a strong password according to your organization’s password policy. Make a note of these credentials. You will need them later to activate the synchronization service.<\/li>\n<\/ol>\n

      The format of the service account name should be something like this: Service_account@yourdomain.com or yourdomain\\Service_account<\/p>\n

       <\/p>\n

      Step 4: Give delegate access to the service account<\/strong><\/h3>\n

      The new service account user needs delegate access to the resources that are to be synchronized.<\/p>\n

      You may set delegation rights in the following manner:<\/p>\n

        \n
      1. Go to Exchange Admin Center<\/li>\n
      2. Select a resource and choose ‘Edit’.<\/li>\n
      3. In the menu item ‘Delegates’ select ‘Select delegates who can accept or decline booking request’<\/li>\n
      4. Add the service account (e.g. officebooking) user, that you’ve just created in the previous step.<\/li>\n
      5. When you\u2019re done adding you delegate user, select the option ‘Accept or decline booking requests automatically’.<\/li>\n
      6. Make sure you save the settings.<\/li>\n<\/ol>\n

         <\/p>\n

        Step 5: Set up the correct title for bookings using PowerShell<\/strong><\/h3>\n

        By default, Exchange removes the title of a meeting in the subject line of the resource and display\u2019s the organizers name. You can fix this by running a PowerShell command.<\/p>\n

          \n
        1. Run PowerShell as an administrator and enter the following command:$UserCredential = Get-Credential<\/li>\n
        2. Enter your login information in the dialog<\/li>\n
        3. Insert your credentials you use to connect to exchange (admin user)$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri
          \nhttps:\/\/outlook.office365.com\/powershell-liveid\/ -Credential $UserCredential -Authentication Basic -AllowRedirection
          \nSet-ExecutionPolicy RemoteSigned<\/li>\n
        4. this opens a connection to office365 with the credentials we just specifiedImport-PSSession $Session<\/li>\n
        5. You\u2019re connected<\/li>\n<\/ol>\n

          Get-Mailbox -RecipientTypeDetails RoomMailbox | Set-CalendarProcessing -AddOrganizerToSubject $false -DeleteSubject $false -DeleteComments $false<\/p>\n

          For more information please check Microsoft documentation online:<\/p>\n

          Managing Office 365 and Exchange Online with Windows PowerShell<\/a><\/p>\n

          Connect to Exchange Online using remote PowerShell<\/a><\/p>\n

           <\/p>\n

          Step 6: Activate synchronization in the OfficeAdmin<\/h3>\n

          To activate the synchronization, you have to add the token to the OfficeAdmin portal.<\/p>\n

            \n
          1. Login to the OfficeAdmin portal and go to the \u2018Settings\u2019 page in your menu. Open the tab \u2018Integrations\u2019 on the top of the page.<\/li>\n
          2. Here you choose the \u2018Exchange (EWS)\u2019 option.<\/li>\n
          3. Enter your EWS access URL, username and password for the Officebooking service account. The access URL will look something like ‘https:\/\/mail.[your company domain]<\/span>\/ews\/Exchange.asmx’.<\/li>\n
          4. Select ‘Save’.<\/li>\n<\/ol>\n

             <\/p>\n

            Step\u00a0<\/strong>7:<\/strong> Connect an asset in Officebooking with the corresponding meeting room<\/strong><\/h3>\n
              \n
            1. Go to \u2018Assets\u2019 page in the left menu of the OfficeAdmin.<\/li>\n
            2. Search for the meeting room you want to connect. It can help to filter on the right category, for example \u2018Meeting room\u2019.<\/li>\n
            3. Select the name of the asset and select\u00a0\u2018Edit\u2019.<\/li>\n
            4. Enter the Exchange email address.<\/li>\n
            5. Now select \u2018Save asset\u2019 to finish connecting the asset.<\/li>\n<\/ol>\n

               <\/p>\n

              Step 8<\/strong>:<\/strong>\u00a0<\/strong>Start testing<\/strong><\/h3>\n

              It\u2019s important to check if the user you\u2019re testing with both exists in your Exchange environment and the Officebooking app for the synchronization to work properly. So please make sure that the user exists in both environments and has the same email address.<\/p>\n

              Single reservation from Outlook > Officebooking<\/strong><\/p>\n

                \n
              1. You may test the integration by creating a meeting in Outlook calendar and invite the room as an attendant.<\/li>\n
              2. Check the confirmation from Outlook. If the room has been successfully added, it will take about 1 minute before the meeting appears in the Officebooking app.<\/li>\n
              3. Now open the OfficeAdmin to check if the reservation has appeared.<\/li>\n
              4. Select\u00a0\u2018Reservations\u2019<\/li>\n
              5. Select the tab \u2018List\u2019 at the top of the page.<\/li>\n
              6. Select the date you\u2019ve created your test reservation and check if the data is correct.\u00a0<\/strong><\/li>\n<\/ol>\n

                Single reservation from Officebooking > Outlook<\/strong><\/p>\n

                The same test can be executed the opposite way.<\/p>\n

                  \n
                1. Log in to the Officebooking app. In our example we use the web app (login.officebooking.net<\/a>).<\/li>\n
                2. Search for the asset that you want to make a test reservation for.<\/li>\n
                3. Create the reservation in the app. You can see that the reservation is added to your personal reservations list on the \u2018My Reservations\u2019<\/li>\n
                4. Now login to the calendar on Exchange as THE SAME USER.<\/li>\n
                5. Check to see if the reservation for the meeting room (that you just made in the app) was added. Remember that there is a synchronization time interval.<\/li>\n<\/ol>\n

                   <\/p>\n

                  Troubleshooting<\/h3>\n

                  I can\u2019t access EWS on my mail server<\/strong><\/p>\n

                  Check the user credentials for the generic Officebooking service account. The username should be something like this: username@yourdomain.com or yourdomain\\username. If the password seems to be incorrect, try resetting the password. Remember to check your URL. It should look like this: https:\/\/mail.yourdomain.com\/ews\/Exchange.asmx<\/p>\n

                  I still have trouble connecting to my service account on Exchange? How can I test if it works?
                  \n<\/strong>
                  \n<\/em>Check connectivity using the Microsoft tool at\u00a0                  https:\/\/testconnectivity.microsoft.com\/<\/a>. If you can successfully connect using this tool, you should have no trouble connecting to Officebooking.<\/p>\n

                    \n
                  1. Open https:\/\/testconnectivity.microsoft.com\/<\/a> in your browser.<\/li>\n
                  2. Select Microsoft Exchange Web Services Connectivity Tests and choose the option ‘Service account Access’.<\/li>\n
                  3. Enter the details of your service account and target resource mailbox (room).<\/li>\n<\/ol>\n

                    I do not see the reservation I made (yet)
                    \n<\/strong>
                    \nWe synchronize every 3-6 minutes with your Exchange server using Exchange Web Services (EWS).
                    \nCheck if the resource mail addresses are identical in both Exchange and Officebooking. Check if the settings of the resource are set to \u2018bookable\u2019.
                    \nCheck if the users match. The users that create the reservation have to exist in both systems.<\/p>\n

                    I activated the synchronization and now I receive cancellations, what\u2019s wrong?
                    \n<\/strong>
                    \n<\/em>Check if the organizing user exists in both Officebooking and Exchange. If the users organizing a meeting (and booking a room), do not exist in BOTH systems (Officebooking AND Exchange), you can get cancellations. We are synchronizing after all! This typically only happens when you are migrating to a new exchange environment AND Officebooking account at the same time. Please make sure you added the relevant users to both environments first.<\/p>\n","protected":false},"excerpt":{"rendered":"

                    The Officebooking platform enables you to share your company resources […]<\/p>\n","protected":false},"author":29,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"content-type":"","footnotes":""},"ht-kb-category":[321],"ht-kb-tag":[],"class_list":["post-72660","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-integrations"],"yoast_head":"\nMicrosoft Exchange \u2013 Meeting room sync (on premise) - Officebooking - Works for you.<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/officebooking.com\/en\/kb-article\/exchange\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Microsoft Exchange \u2013 Meeting room sync (on premise) - Officebooking - Works for you.\" \/>\n<meta property=\"og:description\" content=\"The Officebooking platform enables you to share your company resources [...]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/officebooking.com\/en\/kb-article\/exchange\/\" \/>\n<meta property=\"og:site_name\" content=\"Officebooking - Works for you.\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/Officebooking\/\" \/>\n<meta property=\"article:modified_time\" content=\"2022-08-23T08:25:14+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@officebooking\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/officebooking.com\/en\/kb-article\/exchange\/\",\"url\":\"https:\/\/officebooking.com\/en\/kb-article\/exchange\/\",\"name\":\"Microsoft Exchange \u2013 Meeting room sync (on premise) - Officebooking - Works for you.\",\"isPartOf\":{\"@id\":\"\/#website\"},\"datePublished\":\"2022-01-24T11:59:41+00:00\",\"dateModified\":\"2022-08-23T08:25:14+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/officebooking.com\/en\/kb-article\/exchange\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/officebooking.com\/en\/kb-article\/exchange\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/officebooking.com\/en\/kb-article\/exchange\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/officebooking.com\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Microsoft Exchange \u2013 Meeting room sync (on premise)\"}]},{\"@type\":\"WebSite\",\"@id\":\"\/#website\",\"url\":\"\/\",\"name\":\"Officebooking - Works for you.\",\"description\":\"\",\"publisher\":{\"@id\":\"\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"\/#organization\",\"name\":\"Officebooking\",\"url\":\"\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/07\/Logo-Officebooking-RGB__witte-achtergrond-website-icon.png\",\"contentUrl\":\"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/07\/Logo-Officebooking-RGB__witte-achtergrond-website-icon.png\",\"width\":220,\"height\":54,\"caption\":\"Officebooking\"},\"image\":{\"@id\":\"\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/Officebooking\/\",\"https:\/\/x.com\/officebooking\",\"https:\/\/www.linkedin.com\/company\/officebooking-b-v-\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Microsoft Exchange \u2013 Meeting room sync (on premise) - Officebooking - Works for you.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/officebooking.com\/en\/kb-article\/exchange\/","og_locale":"en_US","og_type":"article","og_title":"Microsoft Exchange \u2013 Meeting room sync (on premise) - Officebooking - Works for you.","og_description":"The Officebooking platform enables you to share your company resources [...]","og_url":"https:\/\/officebooking.com\/en\/kb-article\/exchange\/","og_site_name":"Officebooking - Works for you.","article_publisher":"https:\/\/www.facebook.com\/Officebooking\/","article_modified_time":"2022-08-23T08:25:14+00:00","twitter_card":"summary_large_image","twitter_site":"@officebooking","twitter_misc":{"Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/officebooking.com\/en\/kb-article\/exchange\/","url":"https:\/\/officebooking.com\/en\/kb-article\/exchange\/","name":"Microsoft Exchange \u2013 Meeting room sync (on premise) - Officebooking - Works for you.","isPartOf":{"@id":"\/#website"},"datePublished":"2022-01-24T11:59:41+00:00","dateModified":"2022-08-23T08:25:14+00:00","breadcrumb":{"@id":"https:\/\/officebooking.com\/en\/kb-article\/exchange\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/officebooking.com\/en\/kb-article\/exchange\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/officebooking.com\/en\/kb-article\/exchange\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/officebooking.com\/en\/"},{"@type":"ListItem","position":2,"name":"Microsoft Exchange \u2013 Meeting room sync (on premise)"}]},{"@type":"WebSite","@id":"\/#website","url":"\/","name":"Officebooking - Works for you.","description":"","publisher":{"@id":"\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"\/#organization","name":"Officebooking","url":"\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"\/#\/schema\/logo\/image\/","url":"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/07\/Logo-Officebooking-RGB__witte-achtergrond-website-icon.png","contentUrl":"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/07\/Logo-Officebooking-RGB__witte-achtergrond-website-icon.png","width":220,"height":54,"caption":"Officebooking"},"image":{"@id":"\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/Officebooking\/","https:\/\/x.com\/officebooking","https:\/\/www.linkedin.com\/company\/officebooking-b-v-\/"]}]}},"_links":{"self":[{"href":"https:\/\/officebooking.com\/en\/wp-json\/wp\/v2\/ht-kb\/72660","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/officebooking.com\/en\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/officebooking.com\/en\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/officebooking.com\/en\/wp-json\/wp\/v2\/users\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/officebooking.com\/en\/wp-json\/wp\/v2\/comments?post=72660"}],"version-history":[{"count":4,"href":"https:\/\/officebooking.com\/en\/wp-json\/wp\/v2\/ht-kb\/72660\/revisions"}],"predecessor-version":[{"id":79278,"href":"https:\/\/officebooking.com\/en\/wp-json\/wp\/v2\/ht-kb\/72660\/revisions\/79278"}],"wp:attachment":[{"href":"https:\/\/officebooking.com\/en\/wp-json\/wp\/v2\/media?parent=72660"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/officebooking.com\/en\/wp-json\/wp\/v2\/ht-kb-category?post=72660"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/officebooking.com\/en\/wp-json\/wp\/v2\/ht-kb-tag?post=72660"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}