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

أرسل رسائل بريد إلكتروني معاملاتية من تطبيقك. أدر هويات المرسل وتتبع التسليم من Admin > Email في تطبيقك.

يمكن لكل تطبيق في Proyecta إرسال بريد إلكتروني معاملاتي. تحقق من هوية المرسل، ثم أرسل من كود تطبيقك — دون الحاجة إلى حساب منفصل لدى موفر بريد إلكتروني.

قسم البريد الإلكتروني

افتح Admin > Email في الـ builder — أو /admin على موقعك المنشور. يتكون من جزأين:

الجزء	الغرض منه
Identities	إضافة عناوين بريد إلكتروني أو نطاقات للمرسل والتحقق منها
Sent	استعراض الرسائل المرسلة مع حالة التسليم (مرسلة، مسلَّمة، مرتدة، وغيرها)

يمكنك إضافة هوية مرسل جديدة واستعراض سجل تسليم بريدك الإلكتروني — كل ذلك دون كتابة أي كود.

الإعداد في خطوتين

1. أنشئ هوية مرسل وتحقق منها (عنوان بريد إلكتروني أو نطاق) في لوحة الإدارة الخاصة بك
2. أرسل — من تطبيقك باستخدام useSendEmail()، أو من لوحة الإدارة للحملات البريدية

الإرسال من عنوان مشترك (@proyectamail.com)

أبسط طريقة هي المطالبة بعنوان واحد على النطاق المشترك لـ Proyecta، وهو @proyectamail.com. يتحقق منه فور إنشائه — إذ تمتلك المنصة هذا النطاق بالفعل، لذا لن تحتاج إلى إعداد أي سجلات DNS.

يمكنك فعل ذلك في قسم Emails في لوحة إدارة تطبيقك: أدخل العنوان الذي تريده، وسيكون جاهزًا فورًا.

العناوين المفردة تعمل فقط على @proyectamail.com. أي طلب لعنوان على نطاق آخر (مثل hello@myapp.com) سيُرفض — للإرسال من نطاقك الخاص، تحقق من النطاق بالكامل عوضًا عن ذلك (انظر أدناه). كل عنوان مشترك محجوز عالميًا، لذا لا يمكن لتطبيقين الإرسال من نفس المرسل على @proyectamail.com.

التحقق من نطاقك الخاص (Pro)

للإرسال من نطاقك الخاص — من أي عنوان عليه (hello@، support@، noreply@، وغيرها) — تحقق من النطاق بالكامل. على عكس عنوان @proyectamail.com المشترك، لا يتم التحقق من النطاق المخصص فورًا.

أضف النطاق في نفس قسم Emails. سيُسجَّل لدى موفر البريد الإلكتروني وسيعرض لك سجلات SPF وDKIM وDMARC لنشرها في إعدادات DNS الخاصة بك. يبقى المرسل في حالة pending حتى تنتشر تلك السجلات ويؤكدها الموفر، ثم يتحول إلى verified — استخدم زر إعادة الفحص بعد نشرها.

التحقق من النطاق عبر DNS مُطبَّق بالكامل — يتم إنشاء السجلات بواسطة الموفر وتتحقق كل عملية إعادة فحص من حالتها.

خلف الكواليس: تقوم Proyecta بمصادقة نطاق الإرسال الخاص بك لدى موفر هويات البريد الإلكتروني (Resend) وتسليم رسائلك عبر موفر البريد المعاملاتي (SendGrid). لن تحتاج أبدًا إلى إدارة حساب لدى أيٍّ منهما.

إرسال بريد إلكتروني من تطبيقك

من صفحات تطبيقك، ترسل باستخدام الـ hook المسمى useSendEmail(). تختار قالبًا وتمرر متغيرات؛ تعرض المنصة الرسالة بلغة التطبيق وترسلها:

import { useSendEmail } from '@/hooks/useEmail.ts';

function ConfirmButton({ booking }) {
    const { send, isPending, error } = useSendEmail();

    return (
        <button
            disabled={isPending}
            onClick={() =>
                send({
                    template: 'booking_confirmation',
                    variables: { date: booking.date, service: booking.service },
                })
            }
        >
            Email me the details
        </button>
    );
}

لاحظ ما لا تمرره: المستلم، أو الموضوع، أو HTML. كل قالب يُعرِّف جمهوره الخاص:

• self (تأكيدات الحجز/الطلب، الترحيب) → عنوان المستخدم المسجّل دخوله، مأخوذ من جلسته.
• owner (owner_alert) → مديرو تطبيقك.

كلاهما يتطلب جلسة نشطة. هذا قرار مقصود وليس ثغرة: المفتاح القابل للنشر الذي يصادق على الطلب يُشحن ضمن كود صفحتك، لذا فإن إرسال رسائل لأي مستلم كان سيتيح لأي شخص استخدام تطبيقك كمرحّل للبريد العشوائي. لإشعار نفسك من زائر مجهول، استخدم نموذجًا — مرسلات النماذج تُرسل بريدًا للمالك وتؤكد للمرسل تلقائيًا، وهذا المسار لا يمكن تزويره من المتصفح.

تصل الأخطاء على شكل PlatformApiError: 401 (تتطلب جلسة)، 403 (القالب غير مفعّل لهذا التطبيق)، 429 (تجاوز حد المعدل — اعرض الرسالة وقدّم خيار إعادة المحاولة)، 422 (لا يوجد عنوان بريدي مسجّل).

تتبع التسليم

تسرد تبويبة Sent في لوحة الإدارة كل ما أرسله تطبيقك مع آخر حدث تسليم — مسلَّم، مفتوح، تم النقر عليه، مرتد، أو شُكوى منه — لذا في الغالب لن تحتاج إلى أي كود لهذا الغرض.

يحمل كل إدخال حالته — sent، delivered، opened، clicked، bounced، أو complained — ويمكنك فتح أي رسالة لقراءة HTML والنص الدقيق الذي أُرسل. إذا كانت عمليات التسليم تفشل، فهذا هو أول مكان عليك النظر فيه.

دع الذكاء الاصطناعي يتولى الأمر

لا تحتاج إلى كتابة هذا بنفسك:

• "Verify hello@myapp.com as a sending identity."
• "Email the customer a confirmation after they finish booking."
• "After a successful checkout, send the customer their receipt."
• "Show me the last 20 emails we've sent and whether they bounced."

تحفظات

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

قريبًا

• محرر القوالب — صمم قوالب المعاملات بصريًا في الـ builder
• Bulk/batch send endpoint للمراسلات الجماعية