Email

Надсилайте транзакційні листи зі свого застосунку. Керуйте ідентичностями відправника та відстежуйте доставку в розділі Admin > Email вашого застосунку.

Кожен застосунок Proyecta може надсилати транзакційні листи. Верифікуйте ідентичність відправника, а потім надсилайте листи з коду застосунку — окремий акаунт у поштовому провайдері не потрібен.

Розділ Email

Відкрийте Admin > Email у builder — або перейдіть на /admin вашого опублікованого сайту. Він складається з двох частин:

Частина	Призначення
Identities	Додавання та верифікація email-адрес або доменів відправника
Sent	Перегляд надісланих листів зі статусом доставки (sent, delivered, bounced тощо)

Ви можете додати нову ідентичність відправника та переглядати історію доставки листів — без написання жодного рядка коду.

Налаштування у два кроки

Створіть і верифікуйте ідентичність відправника (email-адресу або домен) у панелі адміністратора
Надішліть лист — з застосунку за допомогою 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). Вам не потрібно керувати акаунтом у жодному з них.

Надсилання листа з застосунку

Зі сторінок застосунку листи надсилаються за допомогою хука 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 у панелі адміністратора відображає всі листи, надіслані вашим застосунком, з останньою подією доставки — delivered, opened, clicked, bounced, complained — тому вам зазвичай не потрібен код для цього.

Кожен запис містить свій статус — 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 для масового/пакетного надсилання для розсилок