אימייל

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

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

תן ל-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 שלך.

בקרוב

• עורך תבניות — עצב תבניות עסקיות באופן ויזואלי ב-builder
• endpoint לשליחה מרוכזת/אצווה לדיוורים המוניים