E-post

Skicka transaktionella e-postmeddelanden från din app. Hantera avsändaridentiteter och spåra leveranser från Dashboard > Emails eller SDK:et.

Varje Proyecta-app kan skicka transaktionell e-post. Verifiera en avsändaridentitet och skicka sedan från din appkod — inget separat e-postleverantörskonto krävs.

Fliken Emails

Öppna Dashboard > Emails i builder. Fliken har två underflikar:

Flik	Vad den används till
Identities	Lägg till och verifiera avsändaradresser eller domäner
Sent	Bläddra bland skickade e-postmeddelanden med leveransstatus (skickat, levererat, studsat osv.)

Du kan lägga till en ny avsändaridentitet och bläddra i din e-postleveranshistorik — allt utan att skriva kod.

Konfigurationen i två steg

1. Skapa och verifiera en avsändaridentitet (en e-postadress eller en domän)
2. Anropa proyecta.email.send() med den verifierade adressen i fältet from

Verifiera en e-postadress

Det enklaste sättet är att verifiera en enskild e-postadress.

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

För att utlösa verifieringskontrollen på nytt:

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

Verifiera en hel domän

För produktionsappar kan du verifiera hela domänen så att du kan skicka från valfri adress på den (hello@, support@, noreply@ osv.).

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

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

DNS-baserad domänverifiering (generering av SPF/DKIM-poster och ny kontroll) är planerad men inte ännu implementerad.

Skicka ett e-postmeddelande

När din identitet är verifierad skickar du med:

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 returnerar det fullständiga skickade e-postobjektet (inklusive id, last_event och meddelandefälten), som du kan använda för att slå upp leveransstatus senare.

Mottagare. to, cc och bcc accepterar alla en enskild adress eller en array.

Innehåll. Ange html, text eller båda. För bästa leveransbarhet bör du inkludera en ren textversion.

Reply-to, anpassade headers och metadatataggar. reply_to stöds (första adressen används). Anpassade headers och metadatataggar accepteras av API:et men vidarebefordras ännu inte till leveransleverantören.

Spåra leveranser

Lista skickade e-postmeddelanden (paginerade) med deras senaste leveranshändelse:

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

Hämta ett enskilt e-postmeddelande med fullständig HTML-/textbrödtext:

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

Låt AI:n sätta upp det

Du behöver inte skriva detta för hand:

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

Saker att tänka på

• from-adressen måste vara en verifierad identitet. Att skicka med en overifierad adress returnerar ett fel.
• Månatliga gränser gäller baserat på din Proyecta-plan.

Kommer snart

• Mallredigerare — designa transaktionella mallar visuellt i builder
• Bulk-/batch-send-endpoint för massutskick