ایمیل

ارسال ایمیل‌های تراکنشی از اپلیکیشن شما. مدیریت هویت‌های فرستنده و پیگیری تحویل از Dashboard > Emails یا SDK.

هر اپلیکیشن Proyecta می‌تواند ایمیل تراکنشی ارسال کند. یک هویت فرستنده را تأیید کن، سپس از کد اپلیکیشنت ارسال کن — بدون نیاز به حساب کاربری جداگانه در یک سرویس ایمیل دیگر.

تب Emails

Dashboard > Emails را در builder باز کن. این تب دو زیر‌تب دارد:

تب	کاربرد
Identities	افزودن و تأیید آدرس‌های ایمیل یا دامنه‌های فرستنده
Sent	مرور ایمیل‌های ارسال‌شده به همراه وضعیت تحویل (sent، delivered، bounced و غیره)

می‌توانی یک هویت فرستنده جدید اضافه کنی و تاریخچه تحویل ایمیل‌هایت را مرور کنی — همه بدون نوشتن کد.

راه‌اندازی دو مرحله‌ای

1. ساخت و تأیید یک هویت فرستنده (یک آدرس ایمیل یا یک دامنه)
2. فراخوانی proyecta.email.send() با آدرس تأییدشده در فیلد from

تأیید یک آدرس ایمیل

ساده‌ترین روش، تأیید یک آدرس ایمیل منفرد است.

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

برای اجرای مجدد بررسی تأیید:

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

تأیید کل یک دامنه

برای اپلیکیشن‌های production، کل دامنه را تأیید کن تا بتوانی از هر آدرسی در آن (hello@، support@، noreply@ و غیره) ارسال کنی.

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

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

تأیید دامنه مبتنی بر DNS (تولید رکورد SPF/DKIM و بررسی مجدد) برنامه‌ریزی شده اما هنوز پیاده‌سازی نشده است.

ارسال ایمیل

پس از تأیید هویتت، با این دستور ارسال کن:

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 آبجکت کامل ایمیل ارسال‌شده (شامل id، last_event و فیلدهای پیام) را برمی‌گرداند که می‌توانی بعداً برای جستجوی وضعیت تحویل از آن استفاده کنی.

گیرندگان. to، cc و bcc هر کدام یک آدرس منفرد یا یک آرایه می‌پذیرند.

محتوا. html، text یا هر دو را ارائه بده. برای بهترین قابلیت تحویل، یک نسخه متن ساده هم اضافه کن.

Reply-to، هدرهای سفارشی، تگ‌های metadata. reply_to پشتیبانی می‌شود (اولین آدرس استفاده می‌شود). هدرهای سفارشی و تگ‌های metadata توسط API پذیرفته می‌شوند اما هنوز به provider تحویل ارسال نمی‌شوند.

پیگیری تحویل

لیست ایمیل‌های ارسال‌شده (صفحه‌بندی‌شده) را به همراه آخرین رویداد تحویلشان دریافت کن:

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'
}

یک ایمیل منفرد را با متن کامل HTML/text دریافت کن:

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

بگذار AI همه چیز را راه‌اندازی کند

نیازی نیست این کارها را دستی انجام بدهی:

• "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."

نکات مهم

• آدرس from باید یک هویت تأییدشده باشد. ارسال با آدرس تأییدنشده خطا برمی‌گرداند.
• محدودیت‌های ماهانه اعمال می‌شوند بر اساس پلن Proyecta تو.

به زودی

• ویرایشگر Template — طراحی بصری قالب‌های تراکنشی در builder
• endpoint ارسال انبوه/دسته‌ای برای ایمیل‌های گروهی