אימייל

שליחת אימיילים טרנזקציוניים מהאפליקציה שלך. ניהול זהויות שולח ומעקב אחר משלוחים מתוך 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 והטקסט המדויקים שנשלחו. אם משלוחים נכשלים, כאן כדאי להתחיל לבדוק.

תן ל-AI לחבר הכול

אין צורך לכתוב את זה ידנית:

• "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
• endpoint לשליחה בכמות/אצווה לדיוור המוני