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 pada email, jadi menjalankan ulang sebuah impor akan memperbarui alih-alih menduplikasi. Tambahkan hingga 1.000 kontak dan gabungkan ke sebuah audiens dalam request yang sama, tanpa langkah keanggotaan terpisah dan tanpa proses de-dupe setelahnya. List yang lebih besar dikirim dalam batch berukuran 1.000. Setiap panggilan bersifat independen, jadi impor yang terputus aman untuk dilanjutkan dari titik berhentinya.
// 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" } },
],
});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.
FAQ Audiens & kontak
Apakah kontak bersifat per-audiens atau global?+
Apa itu registri properti?+
Bagaimana cara mengimpor sebuah daftar?+
Bagaimana hubungan audiens dengan broadcast?+
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.