Zum Inhalt springen
Esc
↑↓navigieren↵öffnen⌘Jvorschau
Auf dieser Seite

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}/send sendet ihn sofort oder zu scheduled_at.
  • POST /broadcasts/{id}/cancel bricht einen geplanten Newsletter-Versand ab, auch einen, der bereits läuft. Bereits gesendete E-Mails werden nicht zurückgeholt. canceled_remaining in der Antwort nennt, wie viele gestoppt wurden, und sent_count beim Lesen, wie viele hinausgegangen sind.
  • Entwürfe und fehlgeschlagene Newsletter-Versände, die nichts gesendet haben, lassen sich löschen.
  • In der API erscheinen scheduled und sending beide als queued. Ein Newsletter-Versand steht auf queued mit leerem sent_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 unsubscribed sind, 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 422 abgelehnt, 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).

  • 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_at ist der geschätzte Zeitpunkt, zu dem die letzte E-Mail hinausgeht. Es ist eine Schätzung, und andere Sendungen können ihn verschieben.
  • warning erscheint, 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 aktuelles finishes_at und sent_count.
  • Eine Zielgruppe, die mehr als 24 Tage Kapazität bräuchte, wird mit 422 broadcast_too_large abgelehnt. 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.

War diese Seite hilfreich?