extension-email-raw

Email — 原始多收件人

面向 Caffeine AI 的原始多收件人邮件扩展。

概述

此技能支持向多个 to、cc 和 bcc 收件人发送邮件。不适用于批量发送服务邮件（收件人会看到彼此）。

后端

此扩展用于发送支持多个 to、cc 和 bcc 地址的邮件。

• 请勿使用此扩展向多位用户发送服务邮件，因为每位收件人都会看到列出的所有其他收件人，这通常会侵犯用户隐私。

发送邮件

• 此扩展依赖 extension-email 来发送邮件。
• 使用 sendRawEmail 函数。
• 它会返回一个 SendResult；如果邮件发送成功，则为 #ok，否则为带有错误文本的 #err(error)。
• 收件人总数最多为 50 位。
• 每位收件人都会收到相同的邮件。

module {
  public type SendResult = {
    #ok;
    #err : Text;
  };

  public func sendRawEmail(
    fromUsername : Text,
    to : [Text],
    cc : [Text],
    bcc : [Text],
    subject : Text,
    htmlBody : Text,
  ) : async SendResult;
};

向会议参会者发送提醒邮件的示例用法。

import Runtime "mo:core/Runtime";
import EmailClient "mo:caffeineai-email/emailClient";

actor {
  public func sendMeetingReminder(
    meetingSubject : Text,
    meetingTime : Text,
    confirmedAttendeeEmails : [Text],
    tentativeAttendeeEmails : [Text],
  ) : async () {
    let result = await EmailClient.sendRawEmail(
      "no-reply",
      confirmedAttendeeEmails,
      tentativeAttendeeEmails,
      [],
      meetingSubject,
      "Reminder the meeting will start at " # meetingTime,
    );

    switch (result) {
      case (#ok) {};
      case (#err(error)) {
        Runtime.trap("Failed to send meeting reminder email: " # error);
      };
    };
  };
};

从先前版本升级

使用 caffeineai-email 0.3.x 构建的应用，通过 mops add [email protected] 重新固定依赖版本。sendRawEmail 保持原有签名。现在，每次发送都会通过邮件网关，并使用平台在每次部署时注入的设置（INTEGRATIONS_GATEWAY_URL / INTEGRATIONS_GATEWAY_API_KEY）；不再使用传输 canister 和 INTEGRATIONS_CANISTER_ID，未提供这些设置时，发送会返回 #err，而不是回退到其他方式。

使用 caffeineai-email 0.2.x 构建的应用，通过 mops add [email protected] 重新固定依赖版本。sendRawEmail 保持原有签名；现在每次发送都会携带幂等键，因此重试的外调只会发送和计费一次。使用验证邮件或营销邮件的应用，请参阅相应技能的升级部分。