Getting Started

Understand the process of integrating webMethods.io Embed with your application website.

Connecting Embed Tenant with Application

Perform the following steps to set up your webMethods.io Embed tenant and integrate it with your application website:

Step 1: Set up webMethods.io Embed tenant

To use webMethods.io Embed, you need a webMethods.io Integration account. You can sign up for one here.

Once you have signed up, send an email to support-wmio@softwareag.com from your registered email address requesting for the webMethods.io Embed feature.

Step 2: Navigate to webMethods.io Embed Admin Portal

Once webMethods.io Embed is enabled for your tenant, you can view the webMethods.io Embed option in the App Switcher panel.

When you click on it, you are redirected to the webMethods.io Embed Admin Portal. From here, you can configure the settings to integrate webMethods.io Embed with your application.

Step 3: Create a default plan in Admin Portal

The Plans tab allows you to define the number of transactions and connectors available under a specific plan, which you can then assign to one or more users.

To get started with configuration settings, first create a default plan. To do so, navigate to Settings > Plans and click on Add Plan.

A new window appears, through which you can create the default plan for your tenant.

Once this is done, click Add. This creates a default plan in your Admin Portal.

Step 4: Download the embedded application code

You can download the code for the embedded application site developed by webMethods.io Embed. You can further modify it as per your requirements or create your custom application site from scratch.

To download the embedded application code, navigate to Settings > Developer Tools and scroll down to the bottom of the page.

Copy the link given in the Download Code for embedded application Field, paste it in a new browser tab, and press Enter key. The embedded application code gets downloaded on your machine.

Step 5: Connect Admin Portal with embedded application

Extract the zipped embedded application code file and open the index.js file in the editor of your choice.

Under the basicAuthCred object, specify the basic authentication credentials for your embedded application.

Now, switch to your webMethods.io Embed Admin portal, navigate to Settings > Developer Tools and locate the following fields:

From here, copy the API Key, Domain, and Identifier keys and replace them with the corresponding placeholder values in the index.js file.

Now, switch back to the Admin portal and set the Runflow URL and Custom OAuth URL.

The Runflow URL is used to execute the workflows which run on webhooks. To set up the Runflow URL, enter your tenant URL in the Runflow URL field and append ‘/runflow’ after it. For example, if your tenant URL is https://demo.int-aws-us.webmethods.io then your ‘Runflow URL will be https://demo.int-aws-us.webmethods.io/runflow .

The Custom OAuth URL is used to display your users the custom OAuth screen based on your company branding while creating the authorization. To set up the Custom OAuth URL, enter your tenant in the Custom OAuth URL field and append ‘/auth’ after it. For example, if your tenant URL is https://acme.int-aws-us.webmethods.io, then your Custom OAuth URL will be https://acme.int-aws-us.webmethods.io/auth.

Note: It is recommended that you proxy the runflow URL and Custom OAuth URL associated with your domain to our domain for a seamless user experience.

With this, your webMethods.io Embed tenant is integrated with your application website.