{"id":64667,"date":"2021-09-16T11:17:46","date_gmt":"2021-09-16T09:17:46","guid":{"rendered":"https:\/\/officebooking.com\/?post_type=ht_kb&p=64667"},"modified":"2023-10-29T14:52:13","modified_gmt":"2023-10-29T13:52:13","slug":"office-365-graph","status":"publish","type":"ht_kb","link":"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/","title":{"rendered":"Office 365 – Meeting room and user data sync (with Graph)"},"content":{"rendered":"

The Officebooking platform facilitates seamless sharing of your company’s resources for user or employee bookings. It offers various user interaction points such as web, mobile, and interactive signage solutions, ensuring comprehensive support for your users at every stage of their experience.<\/p>\n

This step-by-step guide is designed to assist you in integrating your Officebooking platform with Microsoft Office 365 using Graph synchronization.<\/p>\n

Please note: Azure Active Directory is now Microsoft Entra ID. All references in this manual to Active Directory are to be interpreted to ‘Entra ID’.<\/strong><\/p>\n

Synchronization information<\/strong><\/h3>\n

After successful completion of the integration, only new<\/strong> reservations generated after activating the integration will be synced. Reservations, including recurring reservations that were created prior on a resource calendar are not synchronised.\u00a0 Should you wish to synchronize existing reservations made in the past, kindly reach out to Officebooking Support for assistance with importing old reservations.<\/p>\n

New reservations, either created through Outlook Calendar, Outlook Add In or created within the Officebooking Platform with any app are synchronised immediately with Office 365. For recurring reservations we create the first instance of your series, all subsequent events are created during the night.<\/p>\n

Integration Step by Step<\/h3>\n

Step 1: Access to OfficeAdmin and Microsoft Entra ID (Azure Active Directory)<\/strong><\/h3>\n

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

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

Step <\/strong>2:<\/strong> Register Officebooking as an app in Entra ID<\/strong><\/h3>\n

Follow the instructions below.<\/p>\n

    \n
  1. Sign in to the Azure portal:\u00a0https:\/\/portal.azure.com\/<\/a><\/li>\n
  2. In the left-hand navigation pane, select the Microsoft Entra ID<\/strong> service.<\/li>\n
  3. Then select\u00a0App registrations > New registration.<\/li>\n
  4. Give the registration a meaningful name, for example \u2018Officebooking App\u2019.<\/li>\n
  5. Choose \u2018Accounts in this organizational directory only\u2019 as the account type.<\/li>\n
  6. Next, the Redirect URI type in the dropdown should be \u2018Web\u2019.<\/li>\n
  7. Enter https:\/\/[tenant].officebooking.net\/api\/microsoft_graph\/notifications\/notification_url<\/strong> as \u2018Redirect URI\u2019.<\/li>\n
  8. Select \u2018Register\u2019.<\/li>\n<\/ol>\n

    The tenant name is dependent on your subscriptions and contract. Please check with Officebooking Support for information on your tenant name or ID.<\/p>\n

    For general information on registering applications within the Microsoft identity platform please check this link:
    \n    https:\/\/docs.microsoft.com\/en-us\/graph\/auth-register-app-v2<\/a><\/p>\n

    <\/p>\n

    Step <\/strong>3:<\/strong> Saving the required API values<\/strong><\/h3>\n

    After registering the app, you will be redirected to a new page where you can find the following values. Save the Application (client) ID<\/strong> and the Directory (tenant) ID<\/strong>. We need these values later.<\/p>\n

     <\/p>\n

    \"\"<\/p>\n

     <\/p>\n

    Step <\/strong>4:<\/strong>\u00a0Creating a client secret<\/strong><\/h3>\n
      \n
    1. Select \u2018Certificates & secrets\u2019 in the \u2018Manage\u2019 submenu.<\/li>\n
    2. Select the \u2018New client secret\u2019.<\/li>\n
    3. Enter a value in \u2018Description\u2019.<\/li>\n
    4. Next, select one of the options for\u00a0\u2018Expires\u2019.<\/li>\n
    5. Then select \u2018Add\u2019.<\/li>\n<\/ol>\n

      \"\"<\/p>\n

      6. After selecting \u2018Add\u2019 you will be redirected to a new page, here you can find the client secret \u2018Value\u2019.
      \n7. Store the value in your favourite password manager, it will be hidden afterwards. You will need it later when connecting Officebooking in the OfficeAdmin.<\/p>\n

       <\/p>\n

       <\/p>\n

      \"\"<\/p>\n

       <\/p>\n

      Step <\/strong>5:<\/strong>\u00a0Configure Permissions<\/strong><\/h3>\n
        \n
      1. Select \u2018API permissions\u2019 in the left menu.<\/li>\n
      2. Select \u2018Add a permission\u2019.<\/li>\n
      3. Select \u2018Microsoft Graph\u2019 as API.<\/span><\/li>\n
      4. Then select \u2018Application<\/strong> permissions\u2019, not ‘Delegated permissions’.<\/span><\/li>\n<\/ol>\n

        Next you have 2\u00a0different options<\/strong> for the Officebooking app: you can choose to sync only users (in situations where you don’t want to pull the\u00a0 meeting room calendars) or sync both users and calendars (meeting rooms). Officebooking always needs user permissions to successfully synchronise calendars. Other than that the user sync will make sure that once a user no longer works for your company, its account will automatically be deactivated in Officebooking. The user will no longer have access to Officebooking.<\/p>\n

        To sync only users<\/strong>:<\/p>\n

          \n
        1. Open the ‘User’ tab.<\/li>\n
        2. Select \u2018User.Read.All\u2019.<\/span><\/li>\n
        3. Select \u2018Add permissions\u2019.<\/span><\/li>\n<\/ol>\n

          \"\"<\/p>\n

           <\/p>\n

          To sync both users and calendars<\/strong>:<\/p>\n

            \n
          1. Open the ‘User’ tab.<\/li>\n
          2. Select \u2018User.Read.All\u2019.<\/span><\/li>\n
          3. Then, open the ‘Calendars’ tab.<\/li>\n
          4. Select \u2018Calendars.ReadWrite\u2019<\/span><\/li>\n
          5. Select \u2018Add permissions\u2019.<\/span><\/li>\n<\/ol>\n

            \"\"<\/p>\n

            \"\"<\/p>\n

             <\/p>\n

            Next, you have to grant Admin permission to add the permissions to the App.<\/p>\n

              \n
            1. Select the button \u2018Grant admin consent for [your company name]\u2019<\/em><\/li>\n
            2. Follow the steps to successfully grand admin consent for your company.<\/li>\n
            3. The status for all permissions should say ‘Granted for [your company name].<\/li>\n<\/ol>\n

               <\/p>\n

               <\/p>\n

              \"\"<\/p>\n

               <\/p>\n

              Step <\/strong>6:<\/strong> Add the API access token to the OfficeAdmin<\/strong> portal<\/strong><\/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. Then select \u2018Integrations\u2019 in the second menu.<\/li>\n
              2. Here you choose the \u2018Office365\u2019\u00a0option.<\/li>\n
              3. Then enter the different data, that you saved earlier, as follows:<\/li>\n<\/ol>\n

                Domain:\u00a0enter your Office365 company domain. For example: tijdx.nl (without www.)<\/strong>.<\/p>\n

                Tenant id: Directory (Tenant) ID<\/p>\n

                Client id: Application (Client) ID<\/p>\n

                Client key: the Client secret Value<\/strong>, not the secret ID<\/p>\n

                \"\"<\/p>\n

                4. Select \u2018+\u2019 to add the new integration. The integration is saved right away.<\/p>\n

                In case you’re only syncing users with Graph, this is your last step in this implementation process and you can skip the next steps.<\/p>\n

                 <\/p>\n

                Step\u00a0<\/strong>7:<\/strong> Connect an asset in Officebooking with the corresponding meeting room<\/strong><\/h3>\n

                In case you’re only syncing users with Graph, you can skip the next steps.<\/p>\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. Select \u2018Save asset\u2019, to save the email address.<\/li>\n
                6. Now select ‘Edit’ again and select the ‘Subscribe’ button next to the Exchange email address you’ve just entered. Once the email address is entered correctly, the button will show ‘Subscribed to graph’.<\/li>\n
                7. Again select ‘Save asset’ to finish connecting the asset.<\/li>\n<\/ol>\n

                   <\/p>\n

                  \"\"<\/p>\n

                   <\/p>\n

                  Step <\/strong>8:<\/strong>\u00a0Optionally add titles to the meetings in <\/strong>O<\/strong>utlook calendar for synchronisation<\/strong><\/h3>\n

                  By default, Exchange shows the name of the organizer as title of the meeting in the Resource calendar. If you want to display the original title of the meeting room in both the Resource calendar and Officebooking you can enable this setting via PowerShell.<\/p>\n

                  Step <\/strong>9:<\/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\u00a0\u2018List\u2019at 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","protected":false},"excerpt":{"rendered":"

                      The Officebooking platform facilitates seamless sharing of your company’s resources […]<\/p>\n","protected":false},"author":29,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"content-type":"","footnotes":""},"ht-kb-category":[211],"ht-kb-tag":[],"class_list":["post-64667","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-setting-up-officebooking"],"yoast_head":"\nOffice 365 - Meeting room and user data sync (with Graph) - Officebooking - Werkt. Overal.<\/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\/nl\/kb-article\/office-365-graph\/\" \/>\n<meta property=\"og:locale\" content=\"nl_NL\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Office 365 - Meeting room and user data sync (with Graph) - Officebooking - Werkt. Overal.\" \/>\n<meta property=\"og:description\" content=\"The Officebooking platform facilitates seamless sharing of your company’s resources [...]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/\" \/>\n<meta property=\"og:site_name\" content=\"Officebooking - Werkt. Overal.\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/Officebooking\/\" \/>\n<meta property=\"article:modified_time\" content=\"2023-10-29T13:52:13+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/11\/register.jpg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@officebooking\" \/>\n<meta name=\"twitter:label1\" content=\"Geschatte leestijd\" \/>\n\t<meta name=\"twitter:data1\" content=\"9 minuten\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/\",\"url\":\"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/\",\"name\":\"Office 365 - Meeting room and user data sync (with Graph) - Officebooking - Werkt. Overal.\",\"isPartOf\":{\"@id\":\"\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/11\/register.jpg\",\"datePublished\":\"2021-09-16T09:17:46+00:00\",\"dateModified\":\"2023-10-29T13:52:13+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/#breadcrumb\"},\"inLanguage\":\"nl-NL\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"nl-NL\",\"@id\":\"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/#primaryimage\",\"url\":\"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/11\/register.jpg\",\"contentUrl\":\"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/11\/register.jpg\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/officebooking.com\/nl\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Office 365 – Meeting room and user data sync (with Graph)\"}]},{\"@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\":\"nl-NL\"},{\"@type\":\"Organization\",\"@id\":\"\/#organization\",\"name\":\"Officebooking\",\"url\":\"\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"nl-NL\",\"@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":"Office 365 - Meeting room and user data sync (with Graph) - Officebooking - Werkt. Overal.","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\/nl\/kb-article\/office-365-graph\/","og_locale":"nl_NL","og_type":"article","og_title":"Office 365 - Meeting room and user data sync (with Graph) - Officebooking - Werkt. Overal.","og_description":"The Officebooking platform facilitates seamless sharing of your company’s resources [...]","og_url":"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/","og_site_name":"Officebooking - Werkt. Overal.","article_publisher":"https:\/\/www.facebook.com\/Officebooking\/","article_modified_time":"2023-10-29T13:52:13+00:00","og_image":[{"url":"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/11\/register.jpg","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_site":"@officebooking","twitter_misc":{"Geschatte leestijd":"9 minuten"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/","url":"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/","name":"Office 365 - Meeting room and user data sync (with Graph) - Officebooking - Werkt. Overal.","isPartOf":{"@id":"\/#website"},"primaryImageOfPage":{"@id":"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/#primaryimage"},"image":{"@id":"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/#primaryimage"},"thumbnailUrl":"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/11\/register.jpg","datePublished":"2021-09-16T09:17:46+00:00","dateModified":"2023-10-29T13:52:13+00:00","breadcrumb":{"@id":"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/#breadcrumb"},"inLanguage":"nl-NL","potentialAction":[{"@type":"ReadAction","target":["https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/"]}]},{"@type":"ImageObject","inLanguage":"nl-NL","@id":"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/#primaryimage","url":"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/11\/register.jpg","contentUrl":"https:\/\/officebooking.com\/wp-content\/uploads\/2020\/11\/register.jpg"},{"@type":"BreadcrumbList","@id":"https:\/\/officebooking.com\/nl\/kb-article\/office-365-graph\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/officebooking.com\/nl\/"},{"@type":"ListItem","position":2,"name":"Office 365 – Meeting room and user data sync (with Graph)"}]},{"@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":"nl-NL"},{"@type":"Organization","@id":"\/#organization","name":"Officebooking","url":"\/","logo":{"@type":"ImageObject","inLanguage":"nl-NL","@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\/nl\/wp-json\/wp\/v2\/ht-kb\/64667","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/officebooking.com\/nl\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/officebooking.com\/nl\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/officebooking.com\/nl\/wp-json\/wp\/v2\/users\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/officebooking.com\/nl\/wp-json\/wp\/v2\/comments?post=64667"}],"version-history":[{"count":18,"href":"https:\/\/officebooking.com\/nl\/wp-json\/wp\/v2\/ht-kb\/64667\/revisions"}],"predecessor-version":[{"id":83045,"href":"https:\/\/officebooking.com\/nl\/wp-json\/wp\/v2\/ht-kb\/64667\/revisions\/83045"}],"wp:attachment":[{"href":"https:\/\/officebooking.com\/nl\/wp-json\/wp\/v2\/media?parent=64667"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/officebooking.com\/nl\/wp-json\/wp\/v2\/ht-kb-category?post=64667"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/officebooking.com\/nl\/wp-json\/wp\/v2\/ht-kb-tag?post=64667"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}