{"id":520,"date":"2019-09-02T09:09:56","date_gmt":"2019-09-02T09:09:56","guid":{"rendered":"https:\/\/www.marketplacedoc.onoffice.de\/einbindung\/"},"modified":"2026-03-03T08:49:54","modified_gmt":"2026-03-03T07:49:54","slug":"integration","status":"publish","type":"page","link":"https:\/\/www.marketplacedoc.onoffice.de\/en\/integration\/","title":{"rendered":"Integration"},"content":{"rendered":"<section  class='av_textblock_section av-jyo5jo6y-7fdfe14620fb853956df7dc43a8d39d0 '   itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/CreativeWork\" ><div class='avia_textblock'  itemprop=\"text\" ><h1><em>Integration<\/em><\/h1>\n<\/div><\/section>\n\n<style type=\"text\/css\" data-created_by=\"avia_inline_auto\" id=\"style-css-av-5ays-dfee786cbc446d94fc0b910afc3f3657\">\n.flex_column.av-5ays-dfee786cbc446d94fc0b910afc3f3657{\nborder-radius:0px 0px 0px 0px;\npadding:0px 0px 0px 0px;\n}\n<\/style>\n<div  class='flex_column av-5ays-dfee786cbc446d94fc0b910afc3f3657 av_one_full  avia-builder-el-1  el_after_av_textblock  avia-builder-el-last  first flex_column_div av-zero-column-padding  column-top-margin'     ><section  class='av_textblock_section av-jyo5jo6y-14-ab4fbc2f62d430dbf8081b5ee741b436 '   itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/CreativeWork\" ><div class='avia_textblock'  itemprop=\"text\" ><h2>Calling the services \/ integration of the iFrame with the service<\/h2>\n<\/div><\/section><br \/>\n\n<style type=\"text\/css\" data-created_by=\"avia_inline_auto\" id=\"style-css-av-jyo5ggp9-29082c61daedccf442914cdf0871af9c\">\n#top .hr.hr-invisible.av-jyo5ggp9-29082c61daedccf442914cdf0871af9c{\nheight:5px;\n}\n<\/style>\n<div  class='hr av-jyo5ggp9-29082c61daedccf442914cdf0871af9c hr-invisible  avia-builder-el-3  el_after_av_textblock  el_before_av_textblock '><span class='hr-inner '><span class=\"hr-inner-style\"><\/span><\/span><\/div><br \/>\n<section  class='av_textblock_section av-jyo5jo6y-13-54ef0ac095db17fec92286b3708dfe64 '   itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/CreativeWork\" ><div class='avia_textblock'  itemprop=\"text\" ><p>After activation, your service will be integrated into enterprise <strong>via iframe<\/strong> .<\/p>\n<p>For the integration, the iframe URL must be <strong>publicly accessible for<\/strong> the service. You share this URL for your service with us <strong>once <\/strong>when we add you as a provider for the Marketplace.<\/p>\n<p>The URL that can be used for the iframe of the service is also signed. We use the <strong>same procedure for this as for the signature when activating<\/strong> a provider.<\/p>\n<p>Your task as a provider is to <strong>independently check the URL against the signature<\/strong>.<\/p>\n<p>The following information is transferred signed when it is called up via the URL:<\/p>\n<ul>\n<li>Client name: <strong>customerName<\/strong><\/li>\n<li>User Web ID: <strong>customerWebId<\/strong><\/li>\n<li>User ID: <strong>userId<\/strong><\/li>\n<li>API claim: <strong>apiClaim. <\/strong>Serves for user verification, see <a href=\"https:\/\/www.marketplacedoc.onoffice.de\/en\/api-calls\/\">Consider user rights when reading via API<\/a>. Must be returned as extendedclaim for read calls, see <a href=\"https:\/\/apidoc.onoffice.de\/marketplace\/\">API documentation &gt;&gt; Marketplace<\/a>. You can find a sample API call with extendedclaim there.<\/li>\n<li>If the user is in a group, group ID: <strong>groupId<\/strong><\/li>\n<li>Timestamp: <strong>timestamp<\/strong> (format: Unix timestamp in seconds, the elapsed seconds since 00:00 UTC Thursday, January 1, 1970)<\/li>\n<li>Parameters defined by macros (e.g. <strong>ID of a property or address<\/strong>; <strong>language<\/strong> parameter language for multilingual properties; language parameter <strong>UserLanguage<\/strong> for the customer&#8217;s language)<\/li>\n<li>Image ID: If images are selected on the Files tab at Properties, the image IDs are passed as the <strong>imageIds <\/strong>parameter.<\/li>\n<\/ul>\n<p>Update parent window and close shop-iframe:<\/p>\n<p>There is the possibility to give a type via the Javascript function <code>processTypeToonOffice(type)<\/code> to close the service-iframe or to trigger the update of the parent window in onOffice enterprise.\u00a0 For example, you could use it to update the parent window after submitting an image or data to enterprise so that the user sees the changes directly.<\/p>\n<p>The message.type is used for this purpose, which can contain the following types:<\/p>\n<ul>\n<li>onOffice.service.refreshParent (parent window in enterprise is refreshed)<\/li>\n<li>onOffice.service.refreshParentAndClose (parent window in enterprise is refreshed and the service popup is closed)<\/li>\n<li>onOffice.service.closeProviderWindow (The service popup is closed)<\/li>\n<\/ul>\n<p>This method is to be implemented by you. In addition to the &#8220;onOfficeType&#8221; parameter, a timestamp and the signature over all values should be sent along. As with the payment popup.<\/p>\n<p>The Javascript function can be seen in the demo store <a href=\"https:\/\/github.com\/onOfficeGmbH\/marketplace-examples\/blob\/master\/examples\/Shop\/js\/providerOrder.js\">here<\/a> and 3 buttons in the demo store trigger the actions <a href=\"https:\/\/github.com\/onOfficeGmbH\/marketplace-examples\/blob\/master\/examples\/Shop\/ShopPage.php\">here<\/a> .<\/p>\n<p><strong>Note Safari:<\/strong><\/p>\n<p>Since Apple&#8217;s Safari browser blocks third party cookies and deletes first party cookies relatively quickly, we recommend enabling them and setting up your service to work without cookies.<\/p>\n<\/div><\/section><br \/>\n\n<style type=\"text\/css\" data-created_by=\"avia_inline_auto\" id=\"style-css-av-jyo5ggp9-12-8fc41afa8fe5add95c59940830ad662c\">\n#top .hr.hr-invisible.av-jyo5ggp9-12-8fc41afa8fe5add95c59940830ad662c{\nheight:15px;\n}\n<\/style>\n<div  class='hr av-jyo5ggp9-12-8fc41afa8fe5add95c59940830ad662c hr-invisible  avia-builder-el-5  el_after_av_textblock  el_before_av_image '><span class='hr-inner '><span class=\"hr-inner-style\"><\/span><\/span><\/div><br \/>\n\n<style type=\"text\/css\" data-created_by=\"avia_inline_auto\" id=\"style-css-av-jyo9cgfn-cf2e63af79138cd03dad808135bc2533\">\n.avia-image-container.av-jyo9cgfn-cf2e63af79138cd03dad808135bc2533 img.avia_image{\nbox-shadow:none;\n}\n.avia-image-container.av-jyo9cgfn-cf2e63af79138cd03dad808135bc2533 .av-image-caption-overlay-center{\ncolor:#ffffff;\n}\n<\/style>\n<div  class='avia-image-container av-jyo9cgfn-cf2e63af79138cd03dad808135bc2533 av-styling-no-styling av-img-linked avia-align-left  avia-builder-el-6  el_after_av_hr  el_before_av_hr '   itemprop=\"image\" itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/ImageObject\" ><div class=\"avia-image-container-inner\"><div class=\"avia-image-overlay-wrap\"><a href=\"https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2023\/01\/Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng.png\" data-srcset=\"https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2023\/01\/Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng.png 1030w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2023\/01\/Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng-300x163.png 300w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2023\/01\/Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng-768x417.png 768w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2023\/01\/Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng-705x383.png 705w\" data-sizes=\"(max-width: 1030px) 100vw, 1030px\" class='avia_image '  aria-label='Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng'><img decoding=\"async\" fetchpriority=\"high\" class='wp-image-1269 avia-img-lazy-loading-not-1269 avia_image ' src=\"https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2023\/01\/Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng.png\" alt='' title='Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng'  height=\"559\" width=\"1030\"  itemprop=\"thumbnailUrl\" srcset=\"https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2023\/01\/Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng.png 1030w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2023\/01\/Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng-300x163.png 300w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2023\/01\/Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng-768x417.png 768w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2023\/01\/Ablaufskizze-Aufruf-Produktuebersicht-1030x559_eng-705x383.png 705w\" sizes=\"(max-width: 1030px) 100vw, 1030px\" \/><\/a><\/div><\/div><\/div><br \/>\n\n<style type=\"text\/css\" data-created_by=\"avia_inline_auto\" id=\"style-css-av-jyo5ggp9-10-7f136dbd0291c0cbda4cc696348d8903\">\n#top .hr.hr-invisible.av-jyo5ggp9-10-7f136dbd0291c0cbda4cc696348d8903{\nheight:15px;\n}\n<\/style>\n<div  class='hr av-jyo5ggp9-10-7f136dbd0291c0cbda4cc696348d8903 hr-invisible  avia-builder-el-7  el_after_av_image  el_before_av_textblock '><span class='hr-inner '><span class=\"hr-inner-style\"><\/span><\/span><\/div><br \/>\n<section  class='av_textblock_section av-jyo5jo6y-11-adc1b4efbdcbc01c18a2f47b53725d40 '   itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/CreativeWork\" ><div class='avia_textblock'  itemprop=\"text\" ><p>Example view of an unlocked service:<\/p>\n<\/div><\/section><br \/>\n\n<style type=\"text\/css\" data-created_by=\"avia_inline_auto\" id=\"style-css-av-jyo5ggp9-8-86736566ee6296bcefabd45199cbb366\">\n#top .hr.hr-invisible.av-jyo5ggp9-8-86736566ee6296bcefabd45199cbb366{\nheight:15px;\n}\n<\/style>\n<div  class='hr av-jyo5ggp9-8-86736566ee6296bcefabd45199cbb366 hr-invisible  avia-builder-el-9  el_after_av_textblock  el_before_av_image '><span class='hr-inner '><span class=\"hr-inner-style\"><\/span><\/span><\/div><br \/>\n\n<style type=\"text\/css\" data-created_by=\"avia_inline_auto\" id=\"style-css-av-jyo9cgfn-9-804dd762c719ab90245f0c6849d427dd\">\n.avia-image-container.av-jyo9cgfn-9-804dd762c719ab90245f0c6849d427dd img.avia_image{\nbox-shadow:none;\n}\n.avia-image-container.av-jyo9cgfn-9-804dd762c719ab90245f0c6849d427dd .av-image-caption-overlay-center{\ncolor:#ffffff;\n}\n<\/style>\n<div  class='avia-image-container av-jyo9cgfn-9-804dd762c719ab90245f0c6849d427dd av-styling-no-styling av-img-linked avia-align-center  avia-builder-el-10  el_after_av_hr  el_before_av_textblock '   itemprop=\"image\" itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/ImageObject\" ><div class=\"avia-image-container-inner\"><div class=\"avia-image-overlay-wrap\"><a href=\"https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop.png\" data-srcset=\"https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop.png 1022w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop-300x267.png 300w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop-768x684.png 768w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop-705x628.png 705w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop-450x401.png 450w\" data-sizes=\"(max-width: 1022px) 100vw, 1022px\" class='avia_image '  aria-label='marketplace_example_shop'><img decoding=\"async\" fetchpriority=\"high\" class='wp-image-521 avia-img-lazy-loading-not-521 avia_image ' src=\"https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop.png\" alt='' title='marketplace_example_shop'  height=\"910\" width=\"1022\"  itemprop=\"thumbnailUrl\" srcset=\"https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop.png 1022w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop-300x267.png 300w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop-768x684.png 768w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop-705x628.png 705w, https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/09\/marketplace_beispielshop-450x401.png 450w\" sizes=\"(max-width: 1022px) 100vw, 1022px\" \/><\/a><\/div><\/div><\/div><br \/>\n<section  class='av_textblock_section av-jyo5jo6y-7-689b15103ebd4af19e38aa326f1bc1d4 '   itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/CreativeWork\" ><div class='avia_textblock'  itemprop=\"text\" ><p>Your service is called up via the menu item <em>&#8220;Marketplace&#8221;<\/em> in onOffice enterprise or via the action bar in the individual modules such as property and addresses.<\/p>\n<p>In this popup you present <strong>your products including prices via iframe<\/strong>. The user can order your products directly. The next step opens the <a href=\"https:\/\/www.marketplacedoc.onoffice.de\/en\/payment-processing\/#Ablauf_Bestellung\">popup <strong>for payment confirmation and processing<\/strong><\/a>. Optionally, your service can also run in a new browser tab.<\/p>\n<\/div><\/section><br \/>\n\n<style type=\"text\/css\" data-created_by=\"avia_inline_auto\" id=\"style-css-av-jyo5ggp9-6-bf1eb6e0c7a86dad6f1053df3de56e41\">\n#top .hr.hr-invisible.av-jyo5ggp9-6-bf1eb6e0c7a86dad6f1053df3de56e41{\nheight:15px;\n}\n<\/style>\n<div  class='hr av-jyo5ggp9-6-bf1eb6e0c7a86dad6f1053df3de56e41 hr-invisible  avia-builder-el-12  el_after_av_textblock  el_before_av_hr '><span class='hr-inner '><span class=\"hr-inner-style\"><\/span><\/span><\/div><br \/>\n\n<style type=\"text\/css\" data-created_by=\"avia_inline_auto\" id=\"style-css-av-jyo5ggp9-4-074a910599e68a97118d18f7a57922a0\">\n#top .hr.hr-invisible.av-jyo5ggp9-4-074a910599e68a97118d18f7a57922a0{\nheight:15px;\n}\n<\/style>\n<div  class='hr av-jyo5ggp9-4-074a910599e68a97118d18f7a57922a0 hr-invisible  avia-builder-el-13  el_after_av_hr  el_before_av_textblock '><span class='hr-inner '><span class=\"hr-inner-style\"><\/span><\/span><\/div><br \/>\n<section  class='av_textblock_section av-jyo5jo6y-5-aad858bfdaae2c419534fb07e275de64 '   itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/CreativeWork\" ><div class='avia_textblock'  itemprop=\"text\" ><h3>Lack of context<\/h3>\n<\/div><\/section><br \/>\n<section  class='av_textblock_section av-jyo5jo6y-3-10135f650f07cfbba969be2f29089fde '   itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/CreativeWork\" ><div class='avia_textblock'  itemprop=\"text\" ><p>Some services, such as floor plan optimization, require a <strong>property or address reference<\/strong>. The user must be in the record of a property or an address at the time of calling this service. The required <strong>information about the context<\/strong>, such as the property ID (estateid) or the address ID, is transferred to you.<\/p>\n<p>For multilingual properties, in addition to the <code>estateid<\/code> parameter, the <code>language<\/code> language parameter is also transferred, which you must specify as <code>estatelanguage<\/code> when reading and writing properties via the API.<\/p>\n<p>If the user is in a place in the software where this reference cannot be made, a message will appear:<\/p>\n<p><em>&#8220;This service can only be called from a property \/ address.&#8221;<\/em><\/p>\n<\/div><\/section><br \/>\n<section  class='av_textblock_section av-jyo5jo6y-2-1e6ef64e6a29fcf6ff9fb6f4eaecc5a4 '   itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/CreativeWork\" ><div class='avia_textblock'  itemprop=\"text\" ><h3>Live and beta clients<\/h3>\n<\/div><\/section><br \/>\n<section  class='av_textblock_section av-jyo5jo6y-1-b81f139a12a06f1d1a0003c3e9517a53 '   itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/CreativeWork\" ><div class='avia_textblock'  itemprop=\"text\" ><p>onOffice enterprise users can be either live or beta customers, in which case the URLs are <strong>&#8220;<a href=\"https:\/\/smart.onoffice.de\">https:\/\/smart.onoffice.de<\/a><\/strong>&#8221; and\u00a0<strong>&#8220;<a href=\"https:\/\/crm-beta.onoffice.de\">https:\/\/crm-beta.onoffice.de<\/a><\/strong>&#8221; respectively. In the live system, the source code is updated monthly on the first Tuesday of every month. In the beta system there is an update of the source code 2x a week, on Tuesday as well as Thursday.<\/p>\n<p>Your provider client is a beta client. The vast majority of clients use live clients. I.e. requests can come from the two URLs &#8220;https:\/\/smart.onoffice.de&#8221; or &#8220;https:\/\/crm-beta.onoffice.de\/&#8221;.<\/p>\n<p><strong>Important note:<\/strong> The URL \u2018https:\/\/crm.onoffice.de\u2019 must be used in the live system from November 2025 onwards. The previous domain \u2018https:\/\/smart.onoffice.de\u2019 will then no longer be valid.<\/p>\n<p>If you have used the source code of our <a href=\"https:\/\/github.com\/onOfficeGmbH\/marketplace-examples\/tree\/master\/examples\/Shop\">demo stores<\/a> as a template, however, you do not need to set anything on your page.<\/p>\n<p>However, if you need the information whether a client is a live or a beta client, this can be read out via macro. If you want to have the macro included in your service URL or activation URL, please let us know at <a href=\"mailto:marketplace-dev@onoffice.de\"><strong>marketplace-dev@onoffice.de<\/strong><\/a>.<\/p>\n<\/div><\/section><br \/>\n<section  class='av_textblock_section av-kpcm375m-b4fa61be5520ed65f0d139f042566745 '   itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/CreativeWork\" ><div class='avia_textblock'  itemprop=\"text\" ><h2>Webhooks \/ failed webhooks<\/h2>\n<\/div><\/section><br \/>\n<section  class='av_textblock_section av-kpcm4s6z-fdc667d0b3d01bb36c0a65f3ad8b3658 '   itemscope=\"itemscope\" itemtype=\"https:\/\/schema.org\/CreativeWork\" ><div class='avia_textblock'  itemprop=\"text\" ><h3>Introduction<\/h3>\n<p>Besides the presentation of your store embedded in an iFrame within onOffice enterprise, there is also the possibility to run your services as webhooks. Webhooks are generally understood to be the calling of specially prepared websites in order to pass on targeted information so that no regular polling has to be carried out for this purpose.<\/p>\n<p>In the Marketplace, webhooks are used to access certain services automatically.<\/p>\n<p>These services have no visible GUI for the user, but run in the background. The webhooks are triggered by certain actions, e.g. when saving a property if certain fields have changed. For example, the Sprengnetter property valuation or the Newsletter Connector are executed as webhooks. If, for example, price or area fields of a property change, the Sprengnetter webhook is triggered, which triggers a new property valuation.<\/p>\n<p>If you would like to have your service executed as a webhook, please get in touch with your contact person at our company during the connection phase. We will then discuss the required parameters (URL to be called, required reference (property or address), filters, which fields trigger the webhook, etc.)<\/p>\n<p>If a service that is executed as a webhook fails, then the user will be informed about it and about the possible cause via email.<\/p>\n<h3>Webhook signature<\/h3>\n<p>The signature for a webhook is calculated in the same way as for <a href=\"https:\/\/www.marketplacedoc.onoffice.de\/en\/activation\/#Signature\">activation<\/a>.<\/p>\n<h3>Webhook specification<\/h3>\n<p>If you would like to run your service as a webhook, please contact your onOffice representative. The following information is required for webhook configuration.<\/p>\n<h4>Basic information<\/h4>\n<p>\u2013 Display name: What should the service be called for users?<br \/>\n\u2013 Target URL: To which URL should the data be sent?<br \/>\n\u2013 Module reference: Which module does the webhook refer to (e.g. \u2018Addresses\u2019 or \u2018Properties\u2019)?<\/p>\n<h4>Triggering action<\/h4>\n<p>Which action should trigger your webhook? The following are possible:<br \/>\n\u2013 Save: The webhook is triggered when a new or existing data record is saved.<br \/>\n\u2013 Delete: The service is notified when a data record is removed.<br \/>\n\u2013 Process manager: The webhook is triggered specifically by an action in the onOffice process manager.<br \/>\n\u2013 Click on service menu item: The call is made manually by the user via a menu item in onOffice enterprise.<\/p>\n<h4>Desired mode<\/h4>\n<p>This mode serves as an additional condition check for the selected action.<\/p>\n<p>\u2013 Filter: The webhook is only triggered if the data record matches a previously defined onOffice filter. (e.g. property with purchase price &gt; \u00a3300,000). Please let us know the filter conditions so that we can set up the filter for you.<br \/>\n\u2013 Changed values: The transfer only takes place if changes have been made to the data.<br \/>\n\u2013 Filter and changed values: A combined condition, i.e. the record must meet the filter and there must be changes.<br \/>\n\u2013 Filter or changed values: The webhook is triggered when the record meets the filter or there are changes.<\/p>\n<h4>Field specifications<\/h4>\n<p>\u2013 You can define specific fields (e.g. \u2018First name\u2019) and check the values in these fields for changes. The webhook is then only triggered if exactly these values change.<br \/>\n\u2013 Fields to be emptied on call: These are fields that should be emptied in onOffice after a successful webhook call.<br \/>\n\u2013 Permitted process manager URL parameters: Define variables that the process manager is allowed to append to your URL when calling.<\/p>\n<h4>User experience<\/h4>\n<p>\u2013 Start note: What information text should be displayed to the user as a push notification in onOffice enterprise when the webhook is triggered? Let us know if you would like to have your own text.<br \/>\n\u2013 Icon: Should an icon\/image be displayed in addition to the info text? In this case, please provide us with the image (256&#215;256 Pixel).<br \/>\n\u2013 Timeout: Time span in seconds that onOffice should wait for a response from your server (1 to 999 seconds).<\/p>\n<h4>URL design with onOffice macros<\/h4>\n<p>onOffice macros can be used directly in the webhook URL to transfer dynamic data from the respective data record.<\/p>\n<p><strong>Example:<\/strong> https:\/\/your-service.com\/api?email=_Email&amp;price=_kaufpreis.<br \/>\n<strong>Complete list:<\/strong> An overview of all available macros can be found in the <a href=\"https:\/\/de.enterprisehilfebeta.onoffice.com\/help_entries\/macros\/?lang=en\">onOffice macro list<\/a>.<\/p>\n<p>If your service is to transfer data via URL, please let us know the relevant macros.<\/p>\n<\/div><\/section><\/p><\/div>\n","protected":false},"excerpt":{"rendered":"","protected":false},"author":4,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"class_list":["post-520","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.4 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Integration - onOffice Marketplace<\/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:\/\/www.marketplacedoc.onoffice.de\/en\/integration\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Integration - onOffice Marketplace\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.marketplacedoc.onoffice.de\/en\/integration\/\" \/>\n<meta property=\"og:site_name\" content=\"onOffice Marketplace\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-03T07:49:54+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"9 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/en\\\/integration\\\/\",\"url\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/en\\\/integration\\\/\",\"name\":\"Integration - onOffice Marketplace\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/#website\"},\"datePublished\":\"2019-09-02T09:09:56+00:00\",\"dateModified\":\"2026-03-03T07:49:54+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/en\\\/integration\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/en\\\/integration\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/en\\\/integration\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/en\\\/homepage\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Integration\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/#website\",\"url\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/\",\"name\":\"onOffice Marketplace\",\"description\":\"Dokumentation\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/#organization\",\"name\":\"onOffice GmbH\",\"url\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/wp-content\\\/uploads\\\/2019\\\/07\\\/onOffice-Logo.png\",\"contentUrl\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/wp-content\\\/uploads\\\/2019\\\/07\\\/onOffice-Logo.png\",\"width\":209,\"height\":72,\"caption\":\"onOffice GmbH\"},\"image\":{\"@id\":\"https:\\\/\\\/www.marketplacedoc.onoffice.de\\\/#\\\/schema\\\/logo\\\/image\\\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Integration - onOffice Marketplace","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:\/\/www.marketplacedoc.onoffice.de\/en\/integration\/","og_locale":"en_US","og_type":"article","og_title":"Integration - onOffice Marketplace","og_url":"https:\/\/www.marketplacedoc.onoffice.de\/en\/integration\/","og_site_name":"onOffice Marketplace","article_modified_time":"2026-03-03T07:49:54+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"9 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.marketplacedoc.onoffice.de\/en\/integration\/","url":"https:\/\/www.marketplacedoc.onoffice.de\/en\/integration\/","name":"Integration - onOffice Marketplace","isPartOf":{"@id":"https:\/\/www.marketplacedoc.onoffice.de\/#website"},"datePublished":"2019-09-02T09:09:56+00:00","dateModified":"2026-03-03T07:49:54+00:00","breadcrumb":{"@id":"https:\/\/www.marketplacedoc.onoffice.de\/en\/integration\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.marketplacedoc.onoffice.de\/en\/integration\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.marketplacedoc.onoffice.de\/en\/integration\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.marketplacedoc.onoffice.de\/en\/homepage\/"},{"@type":"ListItem","position":2,"name":"Integration"}]},{"@type":"WebSite","@id":"https:\/\/www.marketplacedoc.onoffice.de\/#website","url":"https:\/\/www.marketplacedoc.onoffice.de\/","name":"onOffice Marketplace","description":"Dokumentation","publisher":{"@id":"https:\/\/www.marketplacedoc.onoffice.de\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.marketplacedoc.onoffice.de\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.marketplacedoc.onoffice.de\/#organization","name":"onOffice GmbH","url":"https:\/\/www.marketplacedoc.onoffice.de\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.marketplacedoc.onoffice.de\/#\/schema\/logo\/image\/","url":"https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/07\/onOffice-Logo.png","contentUrl":"https:\/\/www.marketplacedoc.onoffice.de\/wp-content\/uploads\/2019\/07\/onOffice-Logo.png","width":209,"height":72,"caption":"onOffice GmbH"},"image":{"@id":"https:\/\/www.marketplacedoc.onoffice.de\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.marketplacedoc.onoffice.de\/en\/wp-json\/wp\/v2\/pages\/520","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.marketplacedoc.onoffice.de\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.marketplacedoc.onoffice.de\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.marketplacedoc.onoffice.de\/en\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.marketplacedoc.onoffice.de\/en\/wp-json\/wp\/v2\/comments?post=520"}],"version-history":[{"count":34,"href":"https:\/\/www.marketplacedoc.onoffice.de\/en\/wp-json\/wp\/v2\/pages\/520\/revisions"}],"predecessor-version":[{"id":1684,"href":"https:\/\/www.marketplacedoc.onoffice.de\/en\/wp-json\/wp\/v2\/pages\/520\/revisions\/1684"}],"wp:attachment":[{"href":"https:\/\/www.marketplacedoc.onoffice.de\/en\/wp-json\/wp\/v2\/media?parent=520"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}