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

Domains

Eine Absenderdomain verifizieren, ihre DNS-Einträge anlegen und sie für Tracking, Empfang und die Aufwärmphase einrichten.

Jede E-Mail muss von einer Domain gesendet werden, die Ihr Team verifiziert hat. Jede andere from-Adresse wird mit 422 abgelehnt. Fügen Sie Domains im Dashboard unter Domains hinzu und verifizieren Sie sie dort, oder nutzen Sie die API.

Eine Domain hinzufügen und verifizieren

curl -X POST https://api.billionsend.com/domains \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.example.com" }'

Die Antwort listet die DNS-Einträge auf, die Sie bei Ihrem DNS-Anbieter anlegen. Eine Subdomain wie mail.example.com eignet sich gut als Absenderdomain. Sobald die Einträge live sind, klicken Sie auf der Domainseite auf Verifizieren oder rufen POST /domains/{id}/verify auf.

Eintrag Zweck
DKIM (zwei CNAMEs, bs1._domainkey und bs2._domainkey) Signiert Ihre E-Mails, damit Anbieter erkennen, dass sie von Ihnen stammen.
MAIL FROM (MX und TXT) Eine Bounce-Adresse auf Ihrer eigenen Domain, damit SPF übereinstimmt.
DMARC (TXT, empfohlen) Sagt Anbietern, was mit E-Mails geschehen soll, die die Prüfungen nicht bestehen. Er blockiert den Versand nicht.

DKIM und MAIL FROM müssen verifiziert sein, bevor Sie senden können. Lassen Sie diese Einträge bei Cloudflare auf Nur DNS (graue Wolke).

Die Domainseite zeigt jeden Eintrag als gefunden, fehlend oder abweichend, live gegen das öffentliche DNS geprüft. GET /domains/{id} liefert dasselbe in records[]. Jeder Eintrag hat einen status (not_started, pending, verified oder failed), einen Wert live für das, was das öffentliche DNS gerade antwortet, und ein kurzes detail, wenn etwas nicht stimmt.

DKIM-Schlüssel rotieren von selbst

BillionSend erstellt für jede Domain einen DKIM-Schlüssel und ersetzt ihn alle 180 Tage, wobei es zwischen den beiden CNAMEs wechselt. Sie legen die Einträge einmal an und fassen sie nie wieder an. Die automatische Rotation lässt sich im Tab Einstellungen der Domain abschalten.

Region

POST /domains akzeptiert ein optionales region. Eine Domain liegt in genau einer Region. Um sie zu verschieben, löschen Sie sie und fügen sie in der anderen Region neu hinzu; ihre DNS-Einträge ändern sich dabei.

Tarifgrenzen

Free Starter Pro und Scale
Absenderdomains pro Team 3 10 Unbegrenzt

Über dem Limit antwortet POST /domains mit 403 plan_limit_reached. Ein Domainname, den bereits ein anderes Team hält, antwortet mit 409.

Aufwärmphase einer neuen Domain

Eine neu registrierte Domain sendet mit begrenztem Tagesvolumen, während sie sich einen Ruf aufbaut. Die Obergrenze hängt vom Alter der registrierten Domain ab (example.com bei mail.example.com) und zählt pro UTC-Tag:

Alter der Domain E-Mails pro Tag
Unter 1 Tag 100
1 bis unter 7 Tage 300
7 bis unter 30 Tage 2.000
30 Tage oder älter Nur das Limit Ihres Tarifs
  • Eine Domain, die sauber sendet, mit wenigen Bounces und ohne Beschwerden, rückt früher eine Stufe auf.
  • Die Obergrenze gilt zusätzlich zu Ihrem Tarif. Ein Upgrade hebt sie nicht auf.
  • Ihre neuen Domains teilen sich ein Tagesvolumen: Eine weitere neue Domain bringt kein zusätzliches Volumen.
  • E-Mails über der Obergrenze gehen nicht verloren. Sie erscheinen als Wartet und gehen am nächsten Tag hinaus, die ältesten zuerst. Wartet bereits viel Post, antwortet ein Versand mit 429 daily_quota_exceeded; versuchen Sie es nach dem Wechsel des UTC-Tags erneut.

Solange eine Obergrenze gilt, zeigt die Domainseite „Aufwärmphase: N/Tag heute“. Alle Schutzmaßnahmen beim Versand finden Sie unter Sendelimits.

Einstellungen

Sobald eine Domain verifiziert ist, stehen diese Einstellungen zur Verfügung:

  • Öffnungs- und Klick-Tracking. Beide sind standardmäßig aus. Schalten Sie sie im Tab Links der Domain ein oder mit open_tracking und click_tracking bei PATCH /domains/{id}. Siehe Tracking.
  • Eigene Subdomains für Tracking und Abmeldung. Liefern Sie getrackte Links und Abmeldelinks von Ihrer eigenen Domain aus. Dafür ist ein kostenpflichtiger Tarif nötig. Siehe Tracking.
  • Abmeldeseite. Das Aussehen der Seite, die Ihre Empfänger sehen: Name, Logo, Farben und Texte. Stellen Sie es im Tab Marke der Domain ein oder mit unsubscribe_page bei PATCH /domains/{id}. Siehe Abmeldungen.
  • TLS erforderlich. Nur an Server zustellen, die TLS unterstützen. Einstellbar im Tab Einstellungen.
  • Standard-Absendername, Absenderadresse und Reply-To. Einstellbar im Tab Einstellungen.

Empfang

Eine verifizierte Domain kann auch E-Mails empfangen. Aktivieren Sie das mit Empfang aktivieren auf der Domainseite oder mit PATCH /domains/{id}:

{ "capabilities": { "receiving": "enabled" } }
  • Nur eine verifizierte Domain kann den Empfang aktivieren. POST /domains mit "receiving": "enabled" antwortet mit 422: Fügen Sie die Domain hinzu, verifizieren Sie sie und aktivieren Sie danach den Empfang.
  • Beim Aktivieren kommen zwei Einträge vom Typ Receiving hinzu: MX-Einträge, die auf mx1.billionsend-dns.com und mx2.billionsend-dns.com zeigen, beide mit Priorität 10. Veröffentlichen Sie beide, damit ein Absender, der einen Server nicht erreicht, es beim anderen erneut versucht. Sie wirken sich nicht auf den Versand aus. Empfängt die Domain bereits anderswo E-Mails, legen Sie die MX-Einträge auf eine Subdomain wie inbound.example.com, denn ein MX-Eintrag mit niedrigerer Nummer würde die E-Mails stattdessen erhalten.
  • Ein Name kann nur in einem Team empfangen. Ein Name, auf dem bereits ein anderes Team empfängt, antwortet mit 409.
  • Standardmäßig empfangen nur die Adressen Ihrer Postfächer E-Mails. Catch-all nimmt jede Adresse der Domain an. Es erfordert einen kostenpflichtigen Tarif und wird im Dashboard oder mit receiving_catch_all bei PATCH /domains/{id} eingestellt.

Gemeinsame Subdomain

Jedes Team erhält außerdem eine Subdomain auf einer gemeinsamen BillionSend-Domain, auf der seine gemeinsamen Postfächer ihre Adressen bekommen. Sie erscheint am Ende von GET /domains mit shared: true. Sie ist bereits verifiziert und schreibgeschützt: PATCH, Verifizieren und DELETE antworten mit 403 forbidden, und sie zählt nicht zu Ihrem Domain-Limit. Sie kann nur von den eigenen Adressen Ihrer Postfächer aus senden.

Eine Domain löschen

DELETE /domains/{id} oder Löschen auf der Domainseite wird in zwei Fällen mit 409 abgelehnt:

  • Ein Thema oder Segment ist an die Domain gebunden. Löschen Sie es oder setzen Sie sein domain_id auf null.
  • Ein geplanter oder laufender Newsletter-Versand nutzt die Domain. Brechen Sie ihn ab oder warten Sie, bis er hinausgegangen ist.

Beim Löschen einer Domain werden auch ihre Postfächer gelöscht. Die Abmeldungen von Empfängern bei dieser Domain bleiben erhalten und gelten wieder, wenn Sie denselben Namen erneut hinzufügen.

API-Schlüssel und Domains

Ein API-Schlüssel lässt sich auf eine Domain beschränken. Ein solcher Schlüssel kann nur von dieser Domain aus senden, und jedes andere from antwortet mit 403 restricted_api_key. Er liest nur die E-Mails, die an dieser Domain eingegangen sind, sieht und ändert unter /domains nur diese Domain (jede andere Domain antwortet mit 404), und die Schlüssel, die er erstellt, sind auf dieselbe Domain beschränkt. Webhooks, Sperrlisten, Vorlagen und alles Übrige, was zum gesamten Team gehört, antworten mit 403 restricted_api_key; die Seite API-Schlüssel listet sie auf. Ein Schlüssel lässt sich auch auf ein Postfach beschränken.

War diese Seite hilfreich?