When your user installs an integration package from the Marketplace, this process either redirects your user back to the Marketplace, or displays a completion message.

Customize Marketplace callback

When you complete the installation of Marketplace integration packages, your user sees the final page of the LAUNCH flow. If you don’t redirect your user back to the Marketplace, you can customize this callback.

  1. Go to your console and select Settings > Appearance Settings.
  2. In the Launch Complete HTML box, define the HTML and JavaScript.

Message examples

Plain HTML message

You can display your own message:

<h1>Congrats - you're connected!</h1>

Integration package message

If your Marketplace integration package includes an install complete message, you can use the InstallCompleteMessage merge field to display messages for each integration package:

<h1><span><span\></h1>

JavaScript postMessage

If you use a popup window, you can display a message with a close button. When your user selects the close button, a JavaScript postMessage sends the result object and closes the popup window.

   <h1>Congrats - you're connected!</h1>
    <button onclick="closeWindow();">OK</button>
    <script type="text/javascript"> 
        function closeWindow() {
            window.opener.postMessage(JSON.stringify(result), '\*');
            window.close(); 
        }
    </script>

JavaScript result object

A JavaScript result object is available to the window on the final page of the Marketplace flow. You can use the result object for more processes, such as to update newly installed Cycles to complete their setup.

Properties

Property Description
accountId Identifies the account that you installed the Marketplace integration package into.
accountApiId Displays the API ID of the account you installed the Marketplace integration package into.
installCompleteMessage Displays the install complete message for the Marketplace integration package.
marketplacePackageId Identifies the Marketplace integration package.
userId Identifies your end user.
cycles Shows the array of cycles you installed as part of the Marketplace integration package.
cycleId Identifies the cycle you installed.
status Displays the status of the cycle you installed.
templateId Identifies the template you installed the cycle from.
templateReleaseId Identifies the template release you installed the cycle from.
webhooks Displays the array of webhooks the cycle contains.
webhooks.stepName Names the webhook step.
webhooks.url Displays the webhook’s URL.
errors Displays the array of error messages when Cyclr activates the newly installed Marketplace Integration Package.

Cross domain issue in Internet Explorer

Internet Explorer doesn’t allow you to use window.opener.postMessage() from a page that’s on a different domain to the opener. You can avoid this problem in two ways.

Proxy iFrame

You can create a popup to a page on your domain with the Marketplace URL embedded as an iFrame. If you embed the URL, your JavaScript posts to window.parent.postMessage(), which is supported across domains. The proxy page then passes the data back to your application either directly on the backend or with window.opener.postMessage().

Redirect after LAUNCH complete

You can use JavaScript in the LAUNCH complete page to redirect your user to a page on your domain, and pass the data from the LAUNCH flow. The new page handles the details on your backend before it closes the popup.