Simpan kontak Anda satu kali, unik berdasarkan email, dan kelompokkan ke dalam audiens yang Anda targetkan dari sebuah broadcast. Registri properti bertipe menjaga data Anda tetap bersih, dan batch upsert 1.000 baris memasukkan sebuah list dengan cepat.
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.
Satu record kontak. Atribut yang tidak melenceng.
Audiens adalah bagian dari Bird Email API: sebuah kontak unik berdasarkan email dan dibagi di seluruh audiens Anda, sebuah audiens hanyalah sekumpulan kontak tersebut, dan atribut selalu berada pada kontak, tidak disalin ke setiap list. Registri properti berarti field yang salah ketik ditolak saat penulisan, bukan ditemukan di tengah kampanye.
Lima hal yang menjaga data Anda tetap bersih.
Model data yang mengurus pembukuannya, sehingga list Anda tidak membusuk.
- 01
Satu record per orang.
Satu kontak per email, dengan nama depan dan belakang, sebuah external ID, dan data kustom Anda sendiri.
- 02
Audiens adalah keanggotaan.
Sebuah audiens adalah sekumpulan kontak yang Anda tambahkan dan hapus secara bebas. Atribut selalu berada pada kontak, tidak pernah disalin ke list.
- 03
Registri properti bertipe.
Tetapkan field kustom Anda di awal: string, number, atau boolean, dengan fallback opsional. Key yang tidak dikenal dan nilai bertipe salah ditolak saat penulisan.
- 04
Batch upsert hingga 1.000.
Upsert hingga 1.000 kontak dalam satu panggilan, dan gabungkan ke sebuah audiens dalam request yang sama.
- 05
Pencarian kecocokan persis.
Temukan sebuah kontak dengan pencocokan email yang persis, sehingga sistem Anda sendiri dapat melakukan sinkronisasi tanpa memindai setiap record.
Masukkan seluruh daftar sekaligus dengan satu panggilan.
Upsert bersifat idempoten berdasarkan identifier yang dibawa setiap entri, sehingga menjalankan ulang impor akan memperbarui data, bukan menduplikasinya. Tambahkan hingga 1.000 kontak dan gabungkan mereka ke audiens dalam satu permintaan yang sama, tanpa langkah keanggotaan terpisah dan tanpa proses de-duplikasi setelahnya. Daftar yang lebih besar diunggah dalam batch 1.000. Setiap panggilan bersifat independen, sehingga impor yang terputus aman untuk dilanjutkan dari titik terakhir berhenti.
// 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);
}
Field yang tidak bisa melenceng.
Data kontak kustom melewati registri bertipe. Deklarasikan setiap field satu kali sebagai string, number, atau boolean, dengan fallback opsional, dan key yang salah ketik atau nilai bertipe salah ditolak saat Anda menuliskannya, bukan ditemukan di tengah jalan kampanye. Karena atribut berada pada kontak, bukan pada list, memindahkan seseorang antar audiens tidak pernah meninggalkan salinan usang.
Bagian lain dari platform Email
Satu API, satu set kunci. Jelajahi kapabilitas lainnya.
Sekitar 40% email komersial dunia sudah berjalan di Bird.
Email transaksional dan marketing di atas infrastruktur yang telah kami jalankan selama satu dekade. Audiens adalah salah satu kapabilitas dari Bird Email API: pengiriman, broadcast, deliverability, suppression, dan analytics sudah termasuk di dalamnya.