Newsletter-Versand
Eine E-Mail an viele Kontakte verfassen, planen und senden, mit Platzhaltern, Versandtempo und Abmeldelink pro Domain.
Ein Newsletter-Versand (Broadcast) ist eine E-Mail an viele Kontakte: an alle, an ein Segment oder an ein Thema. Sie verfassen ihn im Dashboard unter Newsletter-Versand mit Platzhaltern pro Kontakt oder legen ihn per API an.
Einen Newsletter-Versand senden
import { BillionSend } from "@billionsend/node";
const bs = new BillionSend(); // reads BILLIONSEND_API_KEY
const { data, error } = await bs.broadcasts.create({
name: "November news",
segment_id: "SEGMENT_ID",
from: "Acme <news@mail.example.com>",
subject: "What's new",
html: "<p>Hi {{{FIRST_NAME|there}}},</p><p>...</p><p><a href=\"{{{UNSUBSCRIBE_URL}}}\">Unsubscribe</a></p>",
});
if (error) throw error;
await bs.broadcasts.send(data.id, { scheduled_at: "in 1 hour" });
Ohne scheduled_at wird sofort gesendet. Ein Newsletter-Versand braucht in from eine verifizierte Absenderdomain. Im Editor können Sie mit einer gespeicherten Vorlage beginnen.
Lebenszyklus
draft → scheduled → sending → sent
↘ canceled
↘ failed
- Ein neuer Newsletter-Versand ist ein Entwurf, und nur ein Entwurf lässt sich bearbeiten.
POST /broadcasts/{id}/sendsendet ihn sofort oder zuscheduled_at.POST /broadcasts/{id}/cancelbricht einen geplanten Newsletter-Versand ab, auch einen, der bereits läuft. Bereits gesendete E-Mails werden nicht zurückgeholt.canceled_remainingin der Antwort nennt, wie viele gestoppt wurden, undsent_countbeim Lesen, wie viele hinausgegangen sind.- Entwürfe und fehlgeschlagene Newsletter-Versände, die nichts gesendet haben, lassen sich löschen.
- In der API erscheinen
scheduledundsendingbeide alsqueued. Ein Newsletter-Versand steht aufqueuedmit leeremsent_at, bis seine letzte E-Mail hinausgegangen ist.
Wer ihn erhält
Jeder Empfänger wird geprüft, wenn der Newsletter-Versand hinausgeht. Ausgelassen werden:
- Kontakte, die für das gesamte Team
unsubscribedsind, und Kontakte, die sich von der Absenderdomain des Newsletter-Versands abgemeldet haben; - Kontakte, die das Thema des Newsletter-Versands abbestellt haben;
- Adressen auf der Sperrliste.
Die Empfängerzahl, die das Dashboard vor dem Senden anzeigt, lässt diese Kontakte bereits weg.
Die Absenderdomain
Die Absenderdomain des Newsletter-Versands ist die in seiner from-Adresse, zurückgegeben als domain_id. Sie bestimmt:
- Wessen Abmeldungen gelten. Personen, die sich von dieser Domain abgemeldet haben, werden übersprungen. Siehe Abmeldungen.
- Wie der Empfänger ihn sieht. Der Abmeldelink öffnet die eigene Abmeldeseite dieser Domain, auf deren eigener Subdomain, falls sie eine hat.
- Welche Zielgruppe zulässig ist. Ein Thema oder Segment, das an eine andere Domain gebunden ist, wird mit
422abgelehnt, damit eine Marke nie die Zielgruppe einer anderen Marke anschreibt.
Eine Domain lässt sich nicht löschen, solange ein geplanter oder laufender Newsletter-Versand sie nutzt (409).
Platzhalter und Abmeldelinks
- Werte pro Kontakt wie
{{{FIRST_NAME|there}}}werden für jeden Empfänger eingesetzt. Siehe Vorlagen. - Jede E-Mail eines Newsletter-Versands erhält
List-Unsubscribe-Header für die Abmeldung mit einem Klick und einen gehosteten Abmeldelink. Um den Link im Text zu platzieren, schreiben Sie{{{UNSUBSCRIBE_URL}}}.
Versandtempo
Ein Newsletter-Versand, der in die verfügbare Kapazität passt, geht sofort hinaus. Ein größerer geht in Wellen über die nächsten Tage hinaus. Transaktionsmails werden nie hinter einem Newsletter-Versand zurückgehalten: Sie werden vor den restlichen Empfängern eines Newsletter-Versands gesendet.
Der Aufruf zum Senden sagt Ihnen, was zu erwarten ist:
{
"id": "8c1f0b8e-…",
"finishes_at": "2026-09-18T13:26:05Z",
"estimated": true,
"warning": { "code": "paced", "days": 3, "message": "…" }
}
finishes_atist der geschätzte Zeitpunkt, zu dem die letzte E-Mail hinausgeht. Es ist eine Schätzung, und andere Sendungen können ihn verschieben.warningerscheint, wenn der Versand mehr als eine Welle braucht:paced, wenn die Zielgruppe größer ist als die jetzt verfügbare Kapazität,queued_behind, wenn andere Sendungen vorgehen.- Während des Versands enthält
GET /broadcasts/{id}ein aktuellesfinishes_atundsent_count. - Eine Zielgruppe, die mehr als 24 Tage Kapazität bräuchte, wird mit
422 broadcast_too_largeabgelehnt. Teilen Sie sie in kleinere Segmente auf.
Einen Newsletter-Versand duplizieren
POST /broadcasts/{id}/duplicate kopiert jeden Newsletter-Versand, auch einen gesendeten oder fehlgeschlagenen, in einen neuen Entwurf. Im Dashboard nutzen Sie Duplizieren im Menü des Newsletter-Versands.
- Kopiert werden: Segment, Thema, Absender, Betreff,
reply_to, Vorschautext und Inhalt. - Nicht kopiert werden: der Zeitplan, die Zählwerte und der Zustellfortschritt. Die Kopie ist ein normaler Entwurf.
- Der Name ist der des Originals, gefolgt von
(copy).
Wenn ein Newsletter-Versand fehlschlägt
Ein Newsletter-Versand endet als failed, wenn er angenommen wurde, aber nicht hinausgehen kann, oder wenn der Versand immer wieder fehlschlug. GET /broadcasts/{id} liefert dann failure_reason und failed_at. Bereits übergebene E-Mails bleiben gesendet, und die Inhaber des Teams erhalten einmal eine E-Mail.
failure_reason |
Bedeutung |
|---|---|
domain_missing |
Die Absenderdomain wurde gelöscht. |
sender_domain_mismatch |
from liegt nicht mehr auf der Domain, mit der der Newsletter-Versand geplant wurde. |
topic_other_domain |
Das Thema ist an eine andere Domain gebunden. |
segment_other_domain |
Das Segment ist an eine andere Domain gebunden. |
domain_unverified |
Die Absenderdomain blieb über einige Stunden an Wiederholungen unverifiziert. |
retries_exhausted |
Ein anderer Fehler trat immer wieder auf, bis die Wiederholungen aufgebraucht waren. |
Um die Zielgruppe trotzdem zu erreichen, duplizieren Sie den Newsletter-Versand, beheben die Ursache im neuen Entwurf und senden ihn.
Wenn ein Newsletter-Versand abgelehnt wird
403 sending_paused: Ihre Bounce- oder Beschwerderate ist zu hoch. Siehe Sendelimits.403 broadcasts_paused: Newsletter-Versände sind pausiert, entweder plattformweit, bis sich die Raten erholen, oder für Ihr Team durch BillionSend. Transaktionsmails sind nicht betroffen.403 inbox_send_policy: Der Absender liegt auf Ihrer gemeinsamen Postfach-Domain, die keine Newsletter-Versände senden darf.
Erreicht ein Newsletter-Versand das Volumen Ihres Tarifs, wartet der Rest seiner Zielgruppe und geht hinaus, sobald wieder Platz ist. Siehe Tarife und Limits.
Alle Endpunkte für Newsletter-Versände finden Sie in der API-Referenz.