La maggior parte dei mittenti di email transazionali renderizza solo HTML semplice. POST /api/v1/send in modalità modello renderizza invece uno dei tuoi stessi progetti dello studio, motore di fallback completo e blocchi interattivi inclusi. Una ricevuta o conferma attivata dal tuo backend può portare un blocco Valutazione o un upsell Prodotto esattamente come farebbe un invio marketing.
Una ricevuta è una delle email con il tasso di apertura più alto che un'azienda invii — e quasi sempre la più semplice, perché di solito è generata da qualunque libreria transazionale sia stata più facile da collegare, non da qualcosa con un sistema di design annesso.
Progettala una volta, attivala dal tuo backend
Costruisci la ricevuta o la conferma come un normale progetto dello studio, con qualunque blocco abbia senso — una Valutazione per il CSAT post-acquisto, un upsell Prodotto di articolo correlato. Il tuo backend chiama poi la Send API in modalità modello con l'ID del progetto e un oggetto mergeData al posto dei valori dinamici di quello specifico ordine.
Segnalala come transazionale, correttamente
Impostare type su "transactional" salta la soppressione da disiscrizione — una ricevuta deve comunque raggiungere qualcuno che ha rifiutato il marketing — ma mai la soppressione da bounce, dato che un indirizzo genuinamente invalido non dovrebbe continuare a ricevere invii indipendentemente dal tipo di email.
È autenticata come qualsiasi integrazione API
Una chiave API denominata per proprietario, autenticata con Bearer, si conia e revoca dalla sezione Sviluppatori della dashboard. Un'intestazione Idempotency-Key impedisce a una richiesta ritentata di inviare due volte la ricevuta.
Cosa non si trasferisce
La modalità libera (nessun projectId, solo html/text grezzi) salta del tutto la pipeline di rendering — nessun tag di personalizzazione, nessun motore di fallback, inviata esattamente così com'è. È la scelta giusta per qualcosa come un codice OTP una tantum; la modalità modello è quella che vale la pena usare una volta che l'email stessa beneficia di un blocco interattivo.
Per iniziare
Costruisci il modello transazionale come progetto dello studio con i blocchi interattivi che vuoi, conia una chiave API sotto Sviluppatori, e chiama POST /api/v1/send in modalità modello con il tuo mergeData e type: "transactional".