Send message action

Sends a message from the mailbox in response to the incoming message. Two modes:

Template mode — render an existing template defined in Emailgistics Admin.
Inline mode — supply the body and subject directly in the action.

The two modes are mutually exclusive: provide either templateName or body+bodyType, never both. If both are provided (or neither), the action is silently dropped — Emailgistics records a validation error in the rule’s admin log and moves on to other actions in the response.

Action object

type"sendMessage"

Always "sendMessage".

name?string

Optional label for diagnostics.

valueobject

The message to send — see modes below.

Template mode

{
  "type":  "sendMessage",
  "name":  "Send template",
  "value": {
    "templateName":  "Customer Followup",
    "subject":       "Optional subject override",
    "toAddresses":   [{ "emailAddress": { "address": "to@acme.com",  "name": "To User"  } }],
    "ccAddresses":   [{ "emailAddress": { "address": "cc@acme.com",  "name": "CC User"  } }],
    "bccAddresses":  [{ "emailAddress": { "address": "bcc@acme.com", "name": "BCC User" } }]
  }
}

templateNamestring

Name of an existing template in Emailgistics Admin. Required for template mode.

subject?string

Override the template’s subject. Omit to use the template’s configured subject.

toAddressesAddress[]

Primary recipients.

ccAddresses?Address[]

Cc recipients.

bccAddresses?Address[]

Bcc recipients.

Inline mode

{
  "type":  "sendMessage",
  "name":  "Send inline reply",
  "value": {
    "body":      "<p>Thanks for your email.</p><img src=\"cid:logo1\" alt=\"Logo\"/>",
    "bodyType":  "html",
    "subject":   "Re: Coverage question",
    "toAddresses":  [{ "emailAddress": { "address": "to@acme.com", "name": "To User" } }],
    "ccAddresses":  [],
    "bccAddresses": [],
    "inlineAssets": [
      {
        "id":            "logo1",
        "filename":      "logo.png",
        "contentType":   "image/png",
        "base64Content": "iVBORw0KGgo..."
      }
    ]
  }
}

bodystring

The message body. Required for inline mode.

bodyType"html" | "text"

How body is interpreted.

subject?string

The subject line.

toAddressesAddress[]

Primary recipients.

ccAddresses?Address[]

Cc recipients.

bccAddresses?Address[]

Bcc recipients.

inlineAssets?InlineAsset[]

Images to embed by reference (using cid:<id> URLs in body when bodyType is html). The combined size of all inline assets in a single action is capped — large images may be rejected by the action processor.

`Address`

{ "emailAddress": { "address": "user@acme.com", "name": "User Name" } }

This shape matches the from / sender / to / cc / bcc fields in the webhook request payload, so you can echo addresses straight from the incoming payload into a sendMessage action without reshaping them.

`InlineAsset`

idstring

Identifier referenced from the body via <img src="cid:<id>"/>.

filenamestring

Filename for downstream clients.

contentTypestring

MIME type — for example, image/png.

base64Contentstring

Base64-encoded file contents.

Variables

Both modes support variables in the subject and body — same syntax as the rules-based Send action in Emailgistics Admin (e.g., {{from.name}}, {{subject}}, custom-field references). Variables are resolved using fields from the triggering message.

Limitations

No file attachments. If you need to send attachments, use a template configured with attachments in Admin.
Modes are exclusive. Don’t combine templateName with body / bodyType.