Mail & Messaging

Operators for getting a message — or a notification — out of a flow and into a human’s inbox or channel.

Email

Operator	invoke:	What it does
Email (Send)	email.send	Send mail over SMTP — recipients, subject, body, attachments.
Email (Fetch)	email.fetch	Read mail over IMAP/POP3 — useful as an inbound trigger source.

using:
  - zenvara/email

steps:
  - $email:
      invoke: email.send
      on: smtp
      with:
        From: noreply@example.com
        To: [accounting@example.com]
        Subject: "Daily order summary for ${date}"
        Body: "${summary.content}"

The SMTP/IMAP host and credentials live on the connection, referenced as secrets.

Chat & messaging

Operator	invoke:	What it does
Slack	slack.*	Post messages, upload files, interact with channels.
Microsoft Teams	teams.*	Post to Teams channels / chats.
Signal	signal.*	Send Signal messages.
Zoom	zoom.*	Meetings and Zoom API operations.

Notify — one abstraction over many channels

Operator	invoke:	What it does
Notify	notify.*	A channel-agnostic notification verb that routes to whichever backend the connection points at.

Use notify.* when you want a flow to “tell someone” without hard-coding the channel — the environment decides whether that means email, Slack, or Teams, the same way it decides which database db resolves to. This keeps alerting logic portable across environments.

Common pattern: alert on failure

Pair a messaging operator with control flow to notify only when something goes wrong:

- if: "len(errors) > 0"
  $alert:
    invoke: slack.post
    on: ops-channel
    with:
      Text: "Pipeline ${flow-name} hit ${= len(errors)} errors"