E-posta

Uygulamanızdan işlemsel e-postalar gönderin. Gönderici kimliklerini yönetin ve teslimatı Dashboard > Emails bölümünden veya SDK’dan takip edin.

Her Proyecta uygulaması işlemsel e-posta gönderebilir. Bir gönderici kimliğini doğrulayın, ardından uygulama kodunuzdan gönderin — ayrı bir e-posta sağlayıcısı hesabına gerek yoktur.

Emails sekmesi

Builder’da Dashboard > Emails bölümünü açın. Sekmenin iki alt sekmesi vardır:

Sekme	Ne işe yarar
Identities	Gönderici e-posta adresleri veya alan adları ekleyin ve doğrulayın
Sent	Teslimat durumuyla (gönderildi, teslim edildi, geri döndü vb.) gönderilen e-postaları inceleyin

Kod yazmadan yeni bir gönderici kimliği ekleyebilir ve e-posta teslimat geçmişinizi inceleyebilirsiniz.

İki adımlı kurulum

1. Bir gönderici kimliği oluşturun ve doğrulayın (bir e-posta adresi veya alan adı)
2. proyecta.email.send()’i from alanında doğrulanmış adresi kullanarak çağırın

Bir e-posta adresini doğrulama

En basit yol, tek bir e-posta adresini doğrulamaktır.

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

Doğrulama kontrolünü yeniden tetiklemek için:

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

Tüm bir alan adını doğrulama

Üretim uygulamaları için, o alan adındaki herhangi bir adresten (hello@, support@, noreply@ vb.) gönderim yapabilmek amacıyla tüm alan adını doğrulayın.

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

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

DNS tabanlı alan adı doğrulaması (SPF/DKIM kaydı oluşturma ve yeniden kontrol) planlanmış ancak henüz uygulanmamıştır.

E-posta gönderme

Kimliğiniz doğrulandıktan sonra şu şekilde gönderim yapın:

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, daha sonra teslimat durumunu sorgulamak için kullanabileceğiniz tam gönderilmiş e-posta nesnesini (id, last_event ve mesaj alanları dahil) döndürür.

Alıcılar. to, cc ve bcc alanları tek bir adres veya dizi kabul eder.

İçerik. html, text veya her ikisini birden sağlayın. En iyi teslim edilebilirlik için düz metin sürümü de ekleyin.

Reply-to, özel başlıklar, meta veri etiketleri. reply_to desteklenmektedir (ilk adres kullanılır). Özel başlıklar ve meta veri etiketleri API tarafından kabul edilmekte ancak henüz teslimat sağlayıcısına iletilmemektedir.

Teslimatı takip etme

Gönderilen e-postaları en son teslimat olaylarıyla birlikte sayfalandırılmış şekilde listeleyin:

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

Tam HTML/metin gövdesiyle birlikte tek bir e-posta getirin:

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

AI’nın her şeyi bağlamasına izin verin

Bunları kendiniz yazmanıza gerek yok:

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

Dikkat edilmesi gerekenler

• from adresi doğrulanmış bir kimlik olmalıdır. Doğrulanmamış bir adresle gönderim yapmak hata döndürür.
• Aylık limitler, Proyecta planınıza göre belirlenir.

Yakında

• Şablon editörü — builder’da görsel olarak işlemsel şablonlar tasarlayın
• Toplu e-posta gönderimi için Bulk/batch send endpoint