次のような場合に使用： - val がメールを送信する - メールを受信する - 受信メールによってトリガーされる メール関連の val（メール処理の仕組み、添付ファイルの制限、割り当てられた val のメールアドレス）と std/email 経由でのメール送信に対応しています。
Use when a val sends email, receives email, or is triggered by an incoming email. Covers email-type vals (the Email handler shape, attachment limits, the assigned val email address) and sending mail via std/email.
Val Town は双方向のメール操作に対応しています。val は受信メールによってトリガーされること（email タイプの val）も、std/email を使ってメールを送信することも可能です。
email val（fileType: "email"）は、その val に割り当てられたアドレスにメッセージが届いたときに実行されます。
// Learn more: https://docs.val.town/vals/email/
// Email type: {
// from: string,
// to: string[],
// subject?: string,
// text?: string,
// html?: string,
// attachments: File[],
// headers: Record<string, string>
// }
export default async function (e: Email) {
console.log(e.from, e.subject, e.text);
}
ファイルには必ず export が必要です。ハンドラには export default を使用してください。
メッセージ 1 通あたりの上限は 30MB（添付ファイル含む）。 上限を超えたメッセージは受信拒否されます。
ファイルの一覧取得または email タイプのファイル作成時、レスポンスには links.email が含まれます。これがこの val をトリガーするメールアドレスです。
このアドレスは必ず API レスポンスから読み取ってください。アドレスを自前で組み立てることは絶対に避けてください — アドレスのフォーマットはプラットフォーム側が管理しており、変更される可能性があります。
std/email送信には std/email からインポートします:
import { email } from "https://esm.town/v/std/email";
await email({
to: "user@example.com",
subject: "Hello",
text: "Message body",
});
std/email は送信関数そのものを email としてエクスポートしています。
email({ ... }) のように直接呼び出してください。email.send というメソッドは存在しません。
受け付けるフィールドは to、subject、text、html のほか、from、cc、bcc、replyTo、attachments、headers です。
to を指定しない場合は、val オーナーのアドレスへの送信がデフォルト動作となります。
受信と送信を組み合わせることで返信が可能です。
email タイプのハンドラ内で受信メールの from を読み取り、email 関数で返信します:
import { email } from "https://esm.town/v/std/email";
export default async function (e: Email) {
await email({
to: e.from,
subject: `Re: ${e.subject ?? ""}`,
text: "Got it, thanks!",
});
}
email タイプの val を編集した後は、実際のメール受信を待つ代わりに、run_file にサンプルの Email ペイロードを渡してハンドラを手動で呼び出してください。
送信専用の val については、同様にスクリプトを実行し、get_logs で配信エラーが出ていないか確認してください。
Val Town supports both directions: vals can be triggered by incoming mail (email-type vals) and can send mail via std/email.
Email vals (fileType: "email") run when a message is delivered to the val's assigned address.
// Learn more: https://docs.val.town/vals/email/
// Email type: {
// from: string,
// to: string[],
// subject?: string,
// text?: string,
// html?: string,
// attachments: File[],
// headers: Record<string, string>
// }
export default async function (e: Email) {
console.log(e.from, e.subject, e.text);
}
The file must have an export — export default for the handler.
Maximum 30MB per message, including attachments. Larger messages will be rejected.
When you list files or create an email-type file, the response includes links.email — the address that triggers this val. Always read this from the API response. Never construct an email address yourself — the format is owned by the platform and may change.
std/emailFor outgoing mail, import from std/email:
import { email } from "https://esm.town/v/std/email";
await email({
to: "user@example.com",
subject: "Hello",
text: "Message body",
});
std/email exports email as the send function itself — call it directly (email({ ... })); there is no email.send method. It accepts the shape you'd expect: to, subject, text, html, plus from, cc, bcc, replyTo, attachments, and headers. If no to field is specified, it defaults to sending mail to the val owner's address.
Combine the two — read the inbound from in an email-type handler, then call email to reply:
import { email } from "https://esm.town/v/std/email";
export default async function (e: Email) {
await email({
to: e.from,
subject: `Re: ${e.subject ?? ""}`,
text: "Got it, thanks!",
});
}
After editing an email-type val, use run_file with a sample Email payload to invoke the handler manually instead of waiting for a real incoming message. For send-only vals, run the script the same way and check get_logs for delivery errors.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。