Triggering an MPO Task via Mambu Webhook

In most cases, Mambu Process Orchestrator (MPO) tasks are triggered by external events, with MPO acting as a middle layer that responds by executing business logic. In this documentation, we will use the Mambu Banking Engine as the external service triggering a task, but any external service that can send webhook notifications is capable of triggering MPO tasks.

Getting the Webhook URL for an MPO process

To trigger an MPO task, begin by getting the webhook URL to start a new task. To do this, click on the Start node of the process that you want to trigger. In the infobox on the right-hand side, enable Direct url for tasks upload, and click Copy webhook via JSON. Save the copied link as we will use it later.

Getting the Direct Webhook URL in MPO

To find the Webhook URL for an Alias, see the Using Aliases page.

Preparing Mambu to trigger an MPO task

Before you start, define the conditions to trigger the webhook and the JSON payload to send to MPO when the event is triggered.

To create a webhook in the Mambu UI do the following:

  1. Log in to your Mambu instance at https://TENANT_NAME.mambu.com or use your sandbox instance at https://TENANT_NAME.sandbox.mambu.com.
  2. Click on Administration and then open the Webhooks tab.
  3. If Webhook Communications is set to None, change it to Enabled and click Save Changes. Otherwise continue to Step 4.
  4. Open the Notifications tab and click Add Notification.
  5. Enter a name for your webhook.
  6. Select Opt-out underneath Option. This ensures the webhook automatically applies for all of your clients and accounts. Opt-in requires you to enable this webhook notification for each account you have in your instance.
  7. In the Conditions section you can define the conditions that trigger the webhook. Find out more about the conditions you can set by reading the Fields for a webhook section in the Defining a Webhook page.
  8. Enter the URL that you saved from the Getting the webhook URL for an MPO process section in the Web Hook URL input.
  9. Set the Request Type to POST, set Authorization to No Authorization and set Content-Type to application/json.

Configuration settings for creating a Mambu webhook that starts a task in MPO

  1. In the text box, enter a JSON-formatted payload to send with the webhook. You can search under Placeholder for pre-defined patterns to use to pull in any field from Mambu.

Adding a placeholder top the webhook notification

  1. You can preview the JSON payload by clicking the Preview button. When you are done click Save Changes.

For more on how to create webhooks in Mambu, read Defining a New Webhook in our User Guide.