Skip to content
LambogeniusDocs

HL7 MLLP Connector for Azure Logic Apps

Introduction

What the connector does, its operations, and how to choose between the gateway and the built-in trigger.

Service provider/serviceProviders/lamboHl7MllpLicensed together with the HL7 v2 Codec. One token covers both.

MLLP operations that work like the built-in HTTP ones

MLLP (Minimal Lower Layer Protocol) is how most HL7 v2 systems exchange messages: a TCP connection, each message wrapped in start and end block characters, and an acknowledgement (ACK) back for every message. The connector gives Logic Apps a trigger and actions for it that mirror the HTTP operations you already know.

OperationOperation IDWhat it doesHTTP equivalent
When a message is receivedreceiveMessageTrigger. Listens on a TCP port and starts a run for each HL7 message or batch.When an HTTP request is received
Send acknowledgementsendAcknowledgementReturns the ACK on the sender's open connection (Workflow acknowledgement mode).Response
Send messagesendMessageConnects, sends, waits for the ACK and returns it.HTTP
Create acknowledgementcreateAcknowledgementBuilds an ACK (or batch ACK) for a message without sending it.—

Pair it with the HL7 v2 Codec to decode received messages into XML or JSON and to encode outgoing ones. Both connectors can sit in the same Logic App.

Choose a deployment model

The connector ships in two forms that share one MLLP engine. Sending works the same in both. What differs is where the listening TCP port lives.

MLLP gatewayBuilt-in trigger
Works withAny Logic App: Standard on App Service (WS1–WS3), Consumption, hybridLogic Apps Standard where the runtime can accept inbound TCP: hybrid deployment, your own container, or local development
How messages arriveA small container listens for MLLP and posts each message as JSON to the workflow's “When an HTTP request is received” triggerThe “When a message is received” trigger listens inside the Logic Apps runtime
Where it runsAzure Container Apps (Bicep provided), AKS, or a VM next to your HL7 systemsIn the Logic App
SendingStandard: the built-in Send message action. Consumption: a custom connector over the gateway's send APIThe built-in Send message action
Why the gateway exists

MLLP needs raw TCP ports, and Logic Apps on App Service only accept HTTP and HTTPS on ports 80 and 443. That's why Microsoft's own MLLP connector, in preview, runs only on the Logic Apps hybrid deployment model, on a Kubernetes cluster you operate. The gateway receives MLLP elsewhere and turns each message into an HTTPS call, so your Logic Apps stay on the plan they use today. The connector uses its own service provider ID, so it can coexist with Microsoft's.

Not sure? If your Logic App runs on a Workflow Standard plan (WS1–WS3) or Consumption, start with the gateway quick start. If it runs on hybrid deployment or in your own container, start with the built-in quick start.