E-post

Skicka transaktionella e-postmeddelanden från din app. Hantera avsändaridentiteter och spåra leveranser från din apps Admin > Email.

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.

E-postavsnittet

Öppna Admin > Email i byggaren — eller /admin på din publicerade webbplats. Det består av två delar:

Del	Vad det används till
Identities	Lägg till och verifiera avsändarens e-postadresser eller domäner
Sent	Bläddra bland skickade e-postmeddelanden med leveransstatus (skickad, levererad, studsat, osv.)

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

Konfigurationen i två steg

1. Skapa och verifiera en avsändaridentitet (en e-postadress eller en domän) i din adminpanel
2. Skicka — från din app med useSendEmail(), eller från adminpanelen för kampanjer

Skicka från en delad adress (@proyectamail.com)

Det enklaste alternativet är att välja en enskild adress på Proyectas delade utskicksdomän, @proyectamail.com. Den verifieras direkt när du skapar den — plattformen äger redan den domänen, så du behöver inte konfigurera några DNS-poster.

Du gör detta i avsnittet Emails i din apps adminpanel: ange den adress du vill ha, och den är klar omedelbart.

Enskilda adresser fungerar bara på @proyectamail.com. Om du begär en adress på en annan domän (t.ex. hello@myapp.com) avvisas den — för att skicka från din egen domän måste du verifiera hela domänen istället (se nedan). Varje delad adress är reserverad globalt, så inga två appar kan skicka från samma @proyectamail.com-avsändare.

Verifiera din egen domän (Pro)

För att skicka från din egen domän — från vilken adress som helst på den (hello@, support@, noreply@, osv.) — verifierar du hela domänen. Till skillnad från en delad @proyectamail.com-adress verifieras inte en anpassad domän omedelbart.

Lägg till domänen i samma avsnitt Emails. Den registreras hos e-postleverantören och visar dig de SPF-, DKIM- och DMARC-poster som du behöver publicera i din DNS. Avsändaren befinner sig i läget pending tills dessa poster har spridits och bekräftats av leverantören, varefter den övergår till verified — använd knappen för ny kontroll efter att du publicerat posterna.

DNS-baserad domänverifiering är fullt implementerad — posterna genereras av leverantören och varje ny kontroll hämtar deras aktuella status.

Under huven: Proyecta autentiserar din utskicksdomän med sin e-postidentitetsleverantör (Resend) och levererar dina meddelanden via sin transaktionella leverantör (SendGrid). Du hanterar aldrig ett konto hos någondera.

Skicka ett e-postmeddelande från din app

Från din apps sidor skickar du med hooken useSendEmail(). Du väljer en mall och anger variabler; plattformen renderar meddelandet på appens språk och skickar det:

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>
    );
}

Lägg märke till vad du inte anger: en mottagare, ett ämne eller HTML. Varje mall definierar sin egen målgrupp:

• self (boknings-/orderbekräftelser, välkomsthälsningar) → den inloggade användarens egen adress, hämtad från deras session.
• owner (owner_alert) → din apps administratörer.

Båda kräver en aktiv inloggad session. Detta är ett medvetet val, inte en brist: den publicerbara nyckel som autentiserar anropet skickas med i din sidkälla, så att en skickning till godtycklig mottagare skulle låta vem som helst använda din app som ett spamrelä. Använd ett formulär för att meddela dig själv från en anonym besökare — formulärinskickningar skickar redan e-post till ägaren och bekräftar till den som skickade in, och den vägen kan inte förfalskas i webbläsaren.

Fel levereras som PlatformApiError: 401 (session krävs), 403 (mallen är inte aktiverad för den här appen), 429 (hastighetsberänsad — visa meddelandet och erbjud ett nytt försök), 422 (ingen adress registrerad).

Spåra leveranser

Fliken Sent i din adminpanel listar allt din app har skickat med den senaste leveranshändelsen — levererad, öppnad, klickad, studsat, klagomål — så du behöver normalt sett ingen kod för detta alls.

Varje post visar sin status — sent, delivered, opened, clicked, bounced eller complained — och du kan öppna vilket meddelande som helst för att läsa exakt den HTML och den text som skickades. Om leveranser misslyckas är detta det första stället att titta.

Låt AI:n koppla ihop det

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

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

Att tänka på

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

Kommer snart

• Malleditor — designa transaktionella mallar visuellt i byggaren
• Bulk-/batchutskicksendpoint för massutskick