البريد الإلكتروني

أرسل رسائل بريد إلكتروني معاملاتية من تطبيقك. أدر هويات المرسلين وتتبع التسليم من 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 });

التحقق من نطاق كامل

للتطبيقات في بيئة الإنتاج، تحقق من النطاق بأكمله حتى تتمكن من الإرسال من أي عنوان عليه (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 والترويسات المخصصة وعلامات البيانات الوصفية. تدعم reply_to (يُستخدم أول عنوان). الترويسات المخصصة وعلامات البيانات الوصفية يقبلها الـ API لكنها لم تُحوَّل بعد إلى مزود التسليم.

تتبع التسليم

عرض قائمة الرسائل المرسلة (بالصفحات) مع أحدث حدث تسليم لكل منها:

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);

دع الذكاء الاصطناعي يُعدّ كل شيء

لا تحتاج إلى كتابة هذا يدوياً:

• "تحقق من hello@myapp.com كهوية إرسال."
• "أرسل بريداً إلكترونياً ترحيبياً باستخدام Proyecta Email في كل مرة يسجّل فيها مستخدم جديد. استخدم قالب HTML جميل."
• "بعد إتمام عملية الدفع بنجاح، أرسل للعميل إيصالاً باستخدام proyecta.email.send."
• "أرني آخر 20 رسالة بريد إلكتروني أرسلناها وما إذا كانت قد ارتدّت."

تنبيهات

• يجب أن يكون عنوان from هوية متحققاً منها. الإرسال بعنوان غير متحقق منه يُعيد خطأً.
• تنطبق حدود شهرية بناءً على خطة Proyecta الخاصة بك.

قريباً

• محرر القوالب — صمّم قوالب بريد إلكتروني معاملاتية بصرياً في Builder
• endpoint الإرسال الجماعي/الدفعي للإرسال الجماعي