Email

Wysyłaj e-maile transakcyjne ze swojej aplikacji. Zarządzaj tożsamościami nadawcy i śledź dostarczanie w Dashboard > Emails lub za pomocą SDK.

Każda aplikacja Proyecta może wysyłać e-maile transakcyjne. Zweryfikuj tożsamość nadawcy, a następnie wysyłaj z kodu aplikacji — bez potrzeby zakładania osobnego konta u dostawcy poczty e-mail.

Zakładka Emails

Otwórz Dashboard > Emails w builderze. Zakładka zawiera dwie podzakładki:

Zakładka	Do czego służy
Identities	Dodawanie i weryfikowanie adresów e-mail lub domen nadawcy
Sent	Przeglądanie wysłanych e-maili ze statusem dostarczenia (sent, delivered, bounced itp.)

Możesz dodać nową tożsamość nadawcy i przeglądać historię dostarczania e-maili — wszystko bez pisania kodu.

Konfiguracja w dwóch krokach

1. Utwórz i zweryfikuj tożsamość nadawcy (adres e-mail lub domenę)
2. Wywołaj proyecta.email.send() z zweryfikowanym adresem w polu from

Weryfikacja adresu e-mail

Najprostszą ścieżką jest weryfikacja pojedynczego adresu e-mail.

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

Aby ponownie uruchomić sprawdzenie weryfikacji:

await proyecta.email.identities.verify({ identityId: identity.id });

Weryfikacja całej domeny

W przypadku aplikacji produkcyjnych warto zweryfikować całą domenę, aby móc wysyłać z dowolnego adresu w jej obrębie (hello@, support@, noreply@ itd.).

const identity = await proyecta.email.identities.create({
    type: 'domain',
    value: 'myapp.com',
});

// identity.status === 'verified' immediately upon creation

Weryfikacja domeny oparta na DNS (generowanie rekordów SPF/DKIM i ponowne sprawdzanie) jest planowana, ale nie została jeszcze zaimplementowana.

Wysyłanie e-maila

Po zweryfikowaniu tożsamości wyślij e-mail za pomocą:

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 zwraca pełny obiekt wysłanego e-maila (zawierający id, last_event oraz pola wiadomości), który możesz później wykorzystać do sprawdzenia statusu dostarczenia.

Odbiorcy. to, cc i bcc przyjmują pojedynczy adres lub tablicę adresów.

Treść. Podaj html, text lub oba. Dla lepszej dostarczalności zalecamy dołączenie wersji w czystym tekście.

Reply-to, niestandardowe nagłówki, tagi metadanych. reply_to jest obsługiwane (używany jest pierwszy adres). Niestandardowe nagłówki i tagi metadanych są akceptowane przez API, ale nie są jeszcze przekazywane do dostawcy usługi dostarczania.

Śledzenie dostarczania

Wyświetl wysłane e-maile (z paginacją) wraz z ostatnim zdarzeniem dostarczenia:

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'
}

Pobierz pojedynczy e-mail wraz z pełną treścią HTML/tekstową:

const full = await proyecta.email.get('email_abc123');
console.log(full.html, full.text, full.last_event);

Pozwól AI to skonfigurować

Nie musisz pisać tego ręcznie:

• "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."

Ograniczenia

• Adres from musi być zweryfikowaną tożsamością. Wysyłanie z niezweryfikowanego adresu zwraca błąd.
• Obowiązują miesięczne limity uzależnione od Twojego planu Proyecta.

Wkrótce

• Edytor szablonów — wizualne projektowanie szablonów transakcyjnych w builderze
• Endpoint do wysyłki zbiorczej/wsadowej do masowych mailingów