Czyste listy, wbudowane.

Konfiguracja w:

Przechowuj kontakty raz, z unikalnością po adresie e-mail, i grupuj je w odbiorców, do których kierujesz wysyłkę zbiorczą. Typowany rejestr właściwości utrzymuje dane w czystości, a wsadowy upsert 1000 wierszy szybko ładuje listę.

welcome.tsx

200 · 1.2s

import { BirdClient } from "@messagebird/sdk";
import { render } from "@react-email/render";
import { WelcomeEmail } from "./emails/welcome";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const { data, error } = await bird.email.send({
  from:    "Bird <hello@bird.com>",
  to:      ["ada@example.com"],
  subject: "Your invite is ready",
  html:    await render(<WelcomeEmail name="Ada" />),
}).safe();

if (error) throw error;
console.log(data.id);
// → "em_2bX91Yk8h..."

welcome.tsx

200 · 1.2s

import { BirdClient } from "@messagebird/sdk";
import { render } from "@react-email/render";
import { WelcomeEmail } from "./emails/welcome";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const { data, error } = await bird.email.send({
  from:    "Bird <hello@bird.com>",
  to:      ["ada@example.com"],
  subject: "Your invite is ready",
  html:    await render(<WelcomeEmail name="Ada" />),
}).safe();

if (error) throw error;
console.log(data.id);
// → "em_2bX91Yk8h..."

Jeden rekord kontaktu. Atrybuty, które nie dryfują.

Odbiorcy są częścią Bird Email API: kontakt jest unikalny po adresie e-mail i współdzielony między odbiorcami, odbiorca to po prostu zbiór tych kontaktów, a atrybuty zawsze są zapisane na kontakcie, a nie kopiowane na każdą listę. Rejestr właściwości oznacza, że pole z literówką zostaje odrzucone w momencie zapisu, a nie wykryte dopiero w kampanii.

Pięć rzeczy, które utrzymują Twoje dane w czystości.

Model danych prowadzi księgowość, więc Twoje listy się nie psują.

01
Jeden rekord na osobę.
Jeden kontakt na adres e-mail, z imieniem i nazwiskiem, identyfikatorem zewnętrznym oraz własnymi danymi niestandardowymi.
02
Grupy odbiorców to przynależność.
Odbiorca to zbiór kontaktów, które dowolnie dodajesz i usuwasz. Atrybuty zawsze są zapisane na kontakcie, nigdy kopiowane na listę.
03
Typowany rejestr właściwości.
Zdefiniuj pola niestandardowe z góry: string, number lub boolean, z opcjonalnymi wartościami zastępczymi. Nieznane klucze i wartości o błędnym typie są odrzucane w momencie zapisu.
04
Batch upsert do 1000.
Wykonaj upsert do 1000 kontaktów w jednym wywołaniu i przypisz je do odbiorcy w tym samym żądaniu.
05
Wyszukiwanie po dokładnym dopasowaniu.
Znajdź kontakt po dokładnym dopasowaniu adresu e-mail, aby Twoje systemy mogły synchronizować dane bez skanowania każdego rekordu.

Dodaj całą listę jednym wywołaniem.

Upsert jest idempotentny po adresie e-mail, więc ponowne uruchomienie importu aktualizuje dane, zamiast je duplikować. Dodaj do 1000 kontaktów i przypisz je do odbiorcy w tym samym żądaniu, bez osobnego kroku przypisywania i bez późniejszego przebiegu deduplikacji. Większe listy ładuj w partiach po 1000. Każde wywołanie jest niezależne, więc przerwany import można bezpiecznie wznowić od miejsca zatrzymania.

import.ts

202

// Upsert up to 1,000 contacts and add them to an audience at once.
await bird.email.contacts.batchUpsert({
  audienceId: "aud_2bX91Yk8h",
  contacts: [
    { email: "ada@example.com",   firstName: "Ada",   data: { plan: "growth" } },
    { email: "grace@example.com", firstName: "Grace", data: { plan: "free" } },
  ],
});

Pola, które nie mogą się rozjechać.

Niestandardowe dane kontaktu przechodzą przez typowany rejestr. Zadeklaruj każde pole raz jako string, number lub boolean, z opcjonalną wartością zastępczą, a klucz z literówką lub wartość o błędnym typie zostaje odrzucona w chwili zapisu, a nie wykryta w połowie kampanii. Ponieważ atrybuty są zapisane na kontakcie, a nie na liście, przenoszenie kogoś między odbiorcami nigdy nie pozostawia nieaktualnej kopii.

Współpracuje z resztą Email.

Celuj w grupy odbiorców, które tu budujesz, z broadcastu, a te same kontakty otrzymują pocztę transakcyjną przez send API.

FAQ o grupach odbiorców i kontaktach

Czy kontakty są per grupa odbiorców czy globalne?

Globalne. Kontakt jest unikalny po adresie e-mail, a odbiorcy jedynie go referencują. Przenieś kontakt między odbiorcami, a jego atrybuty podążają za nim, ponieważ są zapisane na kontakcie, a nie na liście.

Czym jest rejestr właściwości?

Zamkniętym, typowanym schematem dla Twoich niestandardowych pól kontaktu. Z góry deklarujesz typ każdego pola (string, liczba lub wartość logiczna) z opcjonalną wartością zastępczą; nieznane klucze lub wartości o błędnym typie są odrzucane przy zapisie, więc Twoje dane pozostają czyste.

Jak zaimportować listę?

Wykonaj wsadowy upsert do 1000 kontaktów w jednym wywołaniu i przypisz je do odbiorcy w tym samym żądaniu, bez osobnego kroku dodawania. Upsert jest idempotentny po adresie e-mail, więc ponowne uruchomienie importu aktualizuje dane, zamiast je duplikować.

Jak grupy odbiorców mają się do broadcastów?

Broadcast celuje w jedną grupę odbiorców. Buduj i utrzymuj grupę odbiorców tutaj; odwołuj się do niej po ID przy wysyłce.

Reszta platformy Email

Jedno API, jeden zestaw kluczy. Poznaj pozostałe funkcje.

WysyłkaEmail transakcyjny i marketingowy, szablony oraz wysyłki wsadowe.SzablonyPrzechowywane, wersjonowane szablony e-maili, personalizowane dla każdego odbiorcy przy wysyłce.BroadcastyKampanie marketingowe: utwórz wersję roboczą, wskaż odbiorcę, zaplanuj i wyślij.DostarczalnośćUwierzytelnianie, rozgrzewanie IP, supresja i monitorowanie list blokujących.AnalitykaMetryki dostarczania i zaangażowania w podziale na domenę, ISP i IP.Dedykowane adresy IPZarządzane dedykowane adresy IP i pule, rozgrzewane automatycznie.Domeny wysyłkoweWeryfikacja domeny, podpisywanie DKIM/SPF/DMARC oraz monitorowanie DMARC.SupresjeAutomatyczna, odwracalna supresja odbić, skarg i wypisań z subskrypcji.Przegląd Email APIPełne Email API: wysyłka, dostarczalność, adresy IP, wykluczenia, analityka i wysyłki zbiorcze.

Już około 40% komercyjnej poczty e-mail na świecie działa na Bird.

Poczta transakcyjna i marketingowa na infrastrukturze, którą prowadzimy od dekady. Odbiorcy to jedna z funkcji Bird Email API: wysyłka, wysyłki zbiorcze, dostarczalność, wykluczenia i analityka są dostarczane razem z nim.

Poznaj platformę Email Rozpocznij