Email

Gửi email giao dịch từ ứng dụng của bạn. Quản lý danh tính người gửi và theo dõi trạng thái gửi từ Dashboard > Emails hoặc SDK.

Mọi ứng dụng Proyecta đều có thể gửi email giao dịch. Xác minh danh tính người gửi, sau đó gửi email từ code ứng dụng — không cần tài khoản nhà cung cấp email riêng.

Tab Emails

Mở Dashboard > Emails trong builder. Tab này có hai sub-tab:

Tab	Chức năng
Identities	Thêm và xác minh địa chỉ email hoặc tên miền người gửi
Sent	Xem danh sách email đã gửi kèm trạng thái gửi (sent, delivered, bounced, v.v.)

Bạn có thể thêm danh tính người gửi mới và xem lịch sử gửi email — tất cả mà không cần viết code.

Thiết lập hai bước

1. Tạo và xác minh danh tính người gửi (một địa chỉ email hoặc tên miền)
2. Gọi proyecta.email.send() với địa chỉ đã xác minh trong trường from

Xác minh một địa chỉ email

Cách đơn giản nhất là xác minh một địa chỉ email cụ thể.

import Proyecta from '@proyecta-ai/sdk';

const proyecta = new Proyecta({ apiKey: process.env.PROYECTA_API_KEY });

const identity = await proyecta.email.identities.create({
    type: 'email',
    value: 'hello@myapp.com',
});

// identity.status === 'verified' immediately upon creation

Để kích hoạt lại quá trình kiểm tra xác minh:

await proyecta.email.identities.verify({ identityId: identity.id });

Xác minh toàn bộ tên miền

Đối với các ứng dụng production, hãy xác minh toàn bộ tên miền để bạn có thể gửi từ bất kỳ địa chỉ nào thuộc tên miền đó (hello@, support@, noreply@, v.v.).

const identity = await proyecta.email.identities.create({
    type: 'domain',
    value: 'myapp.com',
});

// identity.status === 'verified' immediately upon creation

Xác minh tên miền qua DNS (tạo bản ghi SPF/DKIM và kiểm tra lại) đang được lên kế hoạch nhưng chưa được triển khai.

Gửi email

Sau khi danh tính được xác minh, hãy gửi email bằng:

await proyecta.email.send({
    from: 'Acme <hello@myapp.com>',
    to: 'customer@example.com',
    subject: 'Your receipt from Acme',
    html: '<p>Thanks for your order — here are the details.</p>',
    text: 'Thanks for your order — here are the details.',
});

send trả về toàn bộ đối tượng email đã gửi (bao gồm id, last_event và các trường nội dung), bạn có thể dùng để tra cứu trạng thái gửi sau này.

Người nhận. to, cc và bcc đều chấp nhận một địa chỉ đơn hoặc một mảng địa chỉ.

Nội dung. Cung cấp html, text hoặc cả hai. Để đạt khả năng gửi tốt nhất, hãy luôn kèm theo phiên bản văn bản thuần túy.

Reply-to, header tùy chỉnh, thẻ metadata. reply_to được hỗ trợ (địa chỉ đầu tiên sẽ được dùng). Header tùy chỉnh và thẻ metadata được API chấp nhận nhưng chưa được chuyển tiếp đến nhà cung cấp gửi email.

Theo dõi trạng thái gửi

Liệt kê các email đã gửi (có phân trang) kèm sự kiện gửi mới nhất:

const { data: emails } = await proyecta.email.list({ limit: 20 });
for (const email of emails) {
    console.log(email.subject, '→', email.last_event);
    // last_event: 'sent' | 'delivered' | 'opened' | 'clicked' | 'bounced' | 'complained'
}

Lấy một email cụ thể kèm toàn bộ nội dung HTML/text:

const full = await proyecta.email.get('email_abc123');
console.log(full.html, full.text, full.last_event);

Để AI lo phần còn lại

Bạn không cần tự viết tất cả những thứ này:

• "Verify hello@myapp.com as a sending identity."
• "Send a welcome email with Proyecta Email whenever a new user signs up. Use a nice HTML template."
• "After a successful checkout, send the customer a receipt using proyecta.email.send."
• "Show me the last 20 emails we've sent and whether they bounced."

Lưu ý

• Địa chỉ from phải là một danh tính đã được xác minh. Gửi bằng địa chỉ chưa xác minh sẽ trả về lỗi.
• Giới hạn hàng tháng áp dụng tùy theo gói Proyecta của bạn.

Sắp ra mắt

• Template editor — thiết kế các mẫu email giao dịch trực quan ngay trong builder
• Bulk/batch send endpoint dành cho việc gửi email hàng loạt