extension-email-raw

メール — 複数の宛先への生メール送信

Caffeine AI向けの、複数の宛先への生メール送信拡張機能です。

概要

このスキルでは、複数の to、cc、bcc の宛先にメールを送信できます。一括配信サービスのメールには適していません（受信者同士に互いのアドレスが表示されます）。

バックエンド

この拡張機能では、複数の to、cc、bcc アドレスに対応したメールを送信できます。

• 受信者全員に他の受信者が表示され、通常はユーザーのプライバシー侵害となるため、複数のユーザーにサービスメールを送信する目的では使用しないでください。

メールの送信

• メールの送信には、extension-email 拡張機能が必要です。
• sendRawEmail 関数を使用してください。
• メールの送信に成功すると #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）を使ってメールゲートウェイを経由します。トランスポートのキャニスターと INTEGRATIONS_CANISTER_ID は使用されなくなり、これらの設定がない状態で送信すると、フォールバックする代わりに #err が返されます。

caffeineai-email 0.2.x でビルドされたアプリは、mops add [email protected] で再ピン留めします。sendRawEmail のシグネチャは変わりません。今後はすべての送信に冪等性キーが付与されるため、再試行されたアウトコールも一度だけ送信・課金されます。検証メールやマーケティングメールを使用するアプリについては、それぞれのスキルのアップグレード手順に従ってください。