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ę.
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..."You can sign in any time at bird.com/login.
Your test API key is on your dashboard, ready to send.
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.
// 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?+
Czym jest rejestr właściwości?+
Jak zaimportować listę?+
Jak grupy odbiorców mają się do broadcastów?+
Reszta platformy Email
Jedno API, jeden zestaw kluczy. Poznaj pozostałe funkcje.
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.