Invio

Inviare email

Invia in sicurezza messaggi transazionali, batch, risposte, allegati e template ospitati.

Contenuto del messaggio

Indica un'identità from su un dominio verificato del workspace, almeno un destinatario to e un contenuto HTML, di testo o un template ospitato pubblicato. Un invio con contenuto diretto può omettere subject, e in quel caso l'oggetto resta vuoto. Se serve, SendHQ genera un'alternativa in testo semplice dall'HTML, ma un'alternativa scritta da te è più affidabile.

Destinatari e crediti

Un messaggio può contenere al massimo 100 destinazioni tra To, Cc e Bcc. Ogni destinazione consuma un credito di consegna per destinatario. Gli indirizzi dei destinatari duplicati dopo la normalizzazione vengono controllati una sola volta per le soppressioni, ma ogni destinazione conta comunque per i limiti del messaggio.

Tentativi sicuri

Invia una Idempotency-Key stabile di al massimo 200 caratteri negli invii singoli e batch. Riutilizzare una chiave con un payload JSON identico riproduce la risposta memorizzata e aggiunge Idempotent-Replayed: true. Modificare un destinatario, il contenuto, un'intestazione o i dati del template con la stessa chiave restituisce 409; anche una richiesta concorrente con quella chiave restituisce 409 mentre la prima è in corso.

Invio batch

POST /emails/batch accetta fino a 100 oggetti messaggio e restituisce un risultato per ogni posizione. Per dati di template personalizzati usa oggetti messaggio separati, invece di inviare un unico template personalizzato a più destinatari.

Risposte e thread

Imposta reply_to_email_id quando rispondi. SendHQ ricava Message-ID, In-Reply-To, References e l'ID del thread esistente. Recupera l'intera conversazione con GET /threads/:id.

Modello di stato

queuedSalvato prima dell'invio al providersentAccettato dal providerdeliveredIl server del destinatario ha accettato la consegnabouncedErrore di consegna permanentecomplainedIl destinatario lo ha segnalato come spamfailedInvio al provider non riuscito