Aller au contenu

Email

Overview

The Email messaging provider allows your digital worker to communicate via email. The current demo setup uses Microsoft Graph credentials for outbound mail, while inbound email is normally handled through an event provider or an email provider webhook. It supports:

Sending emails
Receiving emails (via webhooks)
HTML formatting
Attachments

Setup

Configure Email Settings

{
  "messaging-email": {
    "enabled": true,
    "from_address": "support@example.com",
    "graph_tenant_id": "your-tenant-id",
    "ms_graph_client_id": "your-client-id",
    "ms_graph_client_secret": "your-client-secret",
    "ms_graph_refresh_token": "your-refresh-token"
  }
}

Configure Inbound (Optional)

For receiving emails, set up an event source or webhook with your email provider:
- SendGrid Inbound Parse
- Mailgun Routes
- AWS SES

Run Setup

gtc setup --answers answers.json ./my-bundle

Configuration Options

Option	Required	Description
`enabled`	Yes	Enable/disable provider
`from_address`	Yes	Default from address
`graph_tenant_id`	For Microsoft Graph	Microsoft tenant ID
`ms_graph_client_id`	For Microsoft Graph	Microsoft Graph app/client ID
`ms_graph_client_secret`	For Microsoft Graph	Microsoft Graph client secret
`ms_graph_refresh_token`	For Microsoft Graph	Refresh token used by the pack

Features

Send Plain Text

- id: send_email
  type: reply
  config:
    to: "{{user_email}}"
    subject: "Your Support Request"
    message: "Thank you for contacting us. We'll get back to you shortly."

Send HTML

- id: send_html_email
  type: reply
  config:
    to: "{{user_email}}"
    subject: "Welcome!"
    html: |
      <html>
        <body>
          <h1>Welcome to Our Service!</h1>
          <p>Thank you for signing up.</p>
          <a href="https://example.com/start">Get Started</a>
        </body>
      </html>

With Attachments

- id: send_with_attachment
  type: reply
  config:
    to: "{{user_email}}"
    subject: "Your Report"
    message: "Please find your report attached."
    attachments:
      - url: "https://example.com/report.pdf"
        filename: "report.pdf"

CC and BCC

- id: send_copy
  type: reply
  config:
    to: "{{user_email}}"
    cc: "manager@example.com"
    bcc: "archive@example.com"
    subject: "Support Update"
    message: "Your ticket has been resolved."

Handling Inbound Email

name: handle_email
version: "1.0"

nodes:
  - id: process
    type: reply
    config:
      to: "{{from_address}}"
      subject: "Re: {{subject}}"
      message: "Thank you for your email. We've received your message."

triggers:
  - type: email
    target: process

Next Steps