Email

Надсилайте транзакційні листи зі свого застосунку. Керуйте ідентифікаторами відправника та відстежуйте доставку через 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, власні заголовки, теги метаданих. 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 для масового/пакетного надсилання для розсилок