تخطَّ إلى المحتوى

Email

نظرة عامة

يسمح مزود مراسلة Email للعامل الرقمي بالتواصل عبر البريد الإلكتروني. يستخدم إعداد العرض الحالي بيانات اعتماد Microsoft Graph للبريد الصادر، بينما يعالج البريد الوارد عادة عبر مزود أحداث أو webhook لمزود البريد. يدعم:

إرسال البريد الإلكتروني
استقبال البريد الإلكتروني (عبر webhooks)
تنسيق HTML
المرفقات

messaging-email هو مزود SMTP صادر. لا يستطلع صناديق بريد IMAP أو POP3. عادة يعالج البريد الوارد عبر مزود أحداث أو webhook مزود، مثل SendGrid Inbound Parse أو Mailgun Routes أو AWS SES أو Microsoft Graph subscriptions عندما يدعمها pack المثبت.

الإعداد

اضبط إعدادات البريد الإلكتروني

{
  "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