Integrate with Azure Event Hubs

​

Authentication

​

Before you begin

​

Connect your hub

1. Log in to Next Matter with an admin account.
2. In Automations Library [left-hand navigation panel], click Connect on the Azure Event Hubs tile.
3. Paste your Connection string for a specific event hub from your Azure Portal.

​

Create a consumer group for Next Matter listener

1. In your Azure Portal.
2. In the search bar at the top, type Event Hubs and select Event Hubs from the results.
3. Select your Event Hub Namespace.
4. Select the Event Hub and click it.
5. In the left menu, select Consumer groups (under Entities).
6. Click + Consumer group.
7. Enter a unique name (for example, NM-service).
8. Click Create.

​

Receive data

1. In your Next Matter portal, click Workflows.
2. Click Edit workflow.
3. Click +Add step and select Integration > Azure Event Hubs.
4. Select the Receive event data operation.
5. Select the event hub you want to receive the data from and the consumer group you created for Next Matter.
6. Select the data you need to use in the Next Matter workflow. In the Event data filters, specify the filter path and value (this is the value we’ll be filtering the event for). After we’ve filtered the event payload, we’ll turn the data into variables you can reuse later.
   To get the right path, check the data section of the payload. For example, if your schema looks like the one below and you want to extract the ID data, enter data.inputdata.id in the Property path field. Do not use $ or [] list access.

{
"data":{
  "inputdata":{
     "id": 123,...
  }
 }
}

1. Enter User properties filters to extract custom properties and optionally System properties filters to extract event metadata, such as timestamp.
2. In your workflow, create the next step. It should be a form with short or long text fields. The fields will be populated with the filtered data and the step will automatically be marked as completed. Copy the IDs of the form fields into the Receive event data operation.

1. Enter the IDs of the form fields in the Data destination section and the variable JSON path. For example, if the data looks like the following, the id path will be: $.data.inputdata.id
   Copy

   Ask AI

   {
   "data":{
     "inputdata":{
        "id": 123,...
     }
    }
   }
   

2. Save your changes.
   Testing the integration is not available as it involves data from a future event.

​

Send data from Next Matter to the Event Hub

1. In your Next Matter portal, click Workflows.
2. Click Edit workflow.
3. Click +Add step and select Integration > Azure Event Hubs.
4. Select the Send event to Hub operation.
5. Select the event hub to send the data to.
6. In the Event data field, enter the data you need to send. You can enter the JSON manually or use data references to replace specific data chunks. Your data to send might look like the following:
   
7. (Optional) You can send custom workflow data as properties to the event hub. Enter the name and value of the data chunk, or select a data reference.
8. Save your operation.