Grupy odbiorców i kontakty

Czyste listy, wbudowane.

Konfiguracja w:
Cursor

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..."

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ą.

  1. 01

    Jeden rekord na osobę.

    Jeden kontakt na adres e-mail, z imieniem i nazwiskiem, identyfikatorem zewnętrznym oraz własnymi danymi niestandardowymi.

  2. 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ę.

  3. 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.

  4. 04

    Batch upsert do 1000.

    Wykonaj upsert do 1000 kontaktów w jednym wywołaniu i przypisz je do odbiorcy w tym samym żądaniu.

  5. 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ł.

import.ts
202
// 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.

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.

Zacznij od jednego kanału.
Dodaj kolejne, gdy będziesz gotowy.

Testowy klucz API otrzymasz od razu. Dostęp produkcyjny odblokujesz po dodaniu metody płatności i weryfikacji nadawcy.

Używasz Claude Code, Cursor lub Codex? Skopiuj prompt konfiguracyjny, a Twój agent zainstaluje za Ciebie Bird CLI i umiejętności. Wybierz swój:

Cursor