Grupy odbiorców i kontakty
Czyste listy, wbudowane.
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.
Operacja upsert jest idempotentna względem identyfikatorów zawartych w każdym wpisie, więc ponowne uruchomienie importu aktualizuje dane zamiast je duplikować. W jednym żądaniu można dodać do 1000 kontaktów i przypisać je do grupy odbiorców — bez osobnego kroku członkostwa i bez późniejszego usuwania duplikatów. Większe listy przesyłane są w partiach po 1000. Każde wywołanie jest niezależne, więc przerwany import można bezpiecznie wznowić od miejsca, w którym się zatrzymał.
// Upsert up to 1,000 contacts and add them to an audience at once.
const result = await bird.contacts.batch({
audience_ids: ["adn_01krdgeqcxet5s7t44vh8rt9mg"],
contacts: [
{ email: "ada@example.com", first_name: "Ada", data: { plan: "growth" } },
{ email: "grace@example.com", first_name: "Grace", data: { plan: "free" } },
],
});
// Per-contact results come back in submission order.
for (const item of result.data) {
console.log(item.email, item.status);
}
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.
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.