Entità Consegna Email
Comprendere il ciclo di vita di un invio email, i template dinamici e la gestione degli allegati.
Entità Consegna Email
L'Email Delivery (o Email Job) rappresenta un singolo evento di comunicazione transazionale. Collega la logica della tua applicazione con l'infrastruttura SMTP professionale di DonutWork.
Utilizzo
L'entità Email Delivery viene utilizzata per:
- Inviare email transazionali (ricevute, reset password) utilizzando template predefiniti.
- Iniettare dati dinamici in layout responsive tramite variabili.
- Distribuire documenti legali o tecnici come allegati sicuri.
- Orchestrare comunicazioni da mittenti multipli (Supporto, Billing, Sales).
Flusso Operativo Atteso
L'invio di un'email sicura con allegati segue questo percorso operativo:
Selezione del Template
Identifica il templateId nel tuo Email Gateway. Questo definisce il layout visivo e i segnaposto (placeholder) disponibili per l'iniezione dei dati.
Mapping Variabili e Contesto
Prepara l'oggetto vars contenente i dati dinamici (es. nome cliente, numero ordine) che sostituiranno i segnaposto nel designer.
Codifica Allegati
Converti i tuoi file (PDF, CSV, Immagini) in stringhe Base64. DonutWork elabora queste stringhe per ricreare in modo sicuro gli allegati SMTP.
Invio e Trasmissione
Invia una richiesta POST all'endpoint di consegna. DonutWork valida l'identità del mittente, risolve le variabili, allega i file e trasmette tramite l'SMTP configurato.
Schema Dati (Body JSON)
Il payload per un job di consegna email:
| Campo | Tipo | Descrizione |
|---|---|---|
to | string | Obbligatorio. Indirizzo email del destinatario principale. |
subject | string | Obbligatorio. L'oggetto dell'email. |
from | string | Opzionale. Deve corrispondere a uno dei tuoi "Alternative Senders". |
vars | object | Coppie chiave-valore per i placeholder nel template. |
attachments | array | Elenco di oggetti allegato (vedi sotto). |
cc / bcc | mixed | Stringa o array di destinatari aggiuntivi. |
Oggetto Allegato
| Campo | Tipo | Descrizione |
|---|---|---|
filename | string | Il nome visualizzato del file (es. fattura.pdf). |
type | string | Tipo MIME (es. application/pdf). |
content | string | Il contenuto del file codificato in Base64. |
disposition | string | attachment (default) o inline. |
Grafo delle Chiamate (Relationship)
Come la tua app interagisce con il Gateway per inviare un documento: