# HL7 Trigger

The **HL7 Trigger** receives messages in HL7 format from healthcare systems into the Digibee Integration Platform. HL7 (Health Level 7) is a widely used communications protocol in the healthcare industry for exchanging data between systems and medical devices.

To send HL7 messages from the Platform to external systems, use the [HL7 connector](/documentation/connectors-and-triggers/connectors/industry-solutions/hl7.md).

## **Parameters**

Take a look at the configuration parameters for the trigger.

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Description</th><th>Default value</th><th>Data type</th></tr></thead><tbody><tr><td><strong>HL7 Pipeline Name</strong></td><td>Name of the pipeline.</td><td>hl7-pipeline</td><td>String</td></tr><tr><td><strong>HL7 Message Charset</strong></td><td>Charset used to interpret the HL7 message received by the trigger.</td><td>UTF-8</td><td>String</td></tr><tr><td><strong>Maximum Connection Timeout (in ms)</strong></td><td>Maximum time allowed to establish a connection between the trigger and the client application, in milliseconds.</td><td>600000</td><td>Integer</td></tr><tr><td><strong>Maximum Concurrent Connections</strong></td><td>Maximum number of simultaneous connections the trigger can establish to receive HL7 messages from the client application.</td><td>5</td><td>Integer</td></tr><tr><td><strong>Pipeline Execution Timeout (in ms)</strong></td><td>Maximum time allowed for the pipeline execution before it times out, in milliseconds.</td><td>30000</td><td>Integer</td></tr><tr><td><strong>Filter from Header (MSH-3)</strong></td><td>Value from the HL7 header used to filter messages by type. This field is required and reads the MSH-3 header to identify different message types.</td><td>MSH-3</td><td>Header</td></tr><tr><td><strong>Documentation</strong></td><td>Optional field to describe the connector configuration and any relevant business rules.</td><td>N/A</td><td>String</td></tr></tbody></table>

## **HL7 Trigger in action**

### Filter from Header (MSH-3) parameter - Usage example

The header filters to be included must follow the standard single-word format, as shown in the example below.

<figure><img src="/files/Ubf1GAFaQkpOF8dn9aTX" alt=""><figcaption></figcaption></figure>

Filters already enabled in the parameter settings will keep their original format:

<figure><img src="/files/GnrMj6A6NpgPQIgeKnGk" alt="" width="563"><figcaption></figcaption></figure>

### **Output**

```json
{
 "body": "<HL7_MESSAGE_CONTENT>"
}
```

Message example (anonymized):

{% code overflow="wrap" %}

```json
{
"body": "MSH|^~\\&|TESTE|SFCT|RAPP|RFCT|20080312181835||ADT^A01|0D23ACC3-17CD-4FF4-BE66-AD4A6572079E|P|2.4\rEVN|A01|20080312181835\rPID|1||722347^^^^MR||PATIENT^TEST||19581221|F|||HIGH STREET 91^^SAINT PAUL^MN^55175^USA||(123)456-78-90^^PH|(844)955-17-21^^PH\rPV1|1|I|P166^R8^B4|R|||728625^WRIGHT^AMANDA^^MD^DR\rDG1|1|I9|472|CHRONIC PHARYNGITIS AND NASOPHARYNGITIS||A"
}
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digibee.com/documentation/connectors-and-triggers/triggers/others/hl7.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.