All Products
Search

This Product

    Direct Mail:BatchSendMail

    Document Center

    Direct Mail:BatchSendMail

    Last Updated:Jun 26, 2026

    Mengirim email secara batch.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dm:BatchSendMail

    none

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    TemplateName

    string

    No

    Nama templat yang telah dibuat dan disetujui sebelumnya.

    test1
    AccountName

    string

    Yes

    Alamat pengirim yang dikonfigurasi di Konsol manajemen.

    test@example.com
    ReceiversName

    string

    No

    Nama daftar penerima yang telah dibuat sebelumnya dan memiliki penerima yang diunggah.

    Catatan:

    Jumlah penerima dalam daftar tidak boleh melebihi kuota harian yang tersisa. Jika tidak, pengiriman email akan gagal.

    Jangan hapus daftar penerima hingga setidaknya 10 menit setelah tugas dipicu. Jika tidak, pengiriman email mungkin gagal.

    test2
    AddressType

    integer

    Yes

    Nilai valid:

    • 0: akun acak

    • 1: alamat pengirim.

    1
    TagName

    string

    No

    Nama tag email.

    test3
    ReplyAddress

    string

    No

    Alamat balasan.

    test2***@example.net
    ReplyAddressAlias

    string

    No

    Alias alamat balasan.

    小红
    ClickTrace

    string

    No

    Nilai valid:

    • 1: Mengaktifkan pelacakan data.

    • 0 (default): Menonaktifkan pelacakan data.

    0
    UnSubscribeLinkType

    string

    No

    Jenis tautan berhenti berlangganan yang dihasilkan. Untuk informasi lebih lanjut, lihat Mekanisme pembuatan dan pemfilteran tautan berhenti berlangganan. Nilai valid:

    • disabled: Tidak ada tautan berhenti berlangganan yang dihasilkan.

    • default: Kebijakan default digunakan. Tautan berhenti berlangganan dihasilkan saat email dikirim dari alamat pengirim tipe batch ke domain tertentu yang mengandung kata kunci seperti "gmail", "yahoo", "google", "aol.com", "hotmail", "outlook", atau "ymail.com".

    Bahasa tampilan ditentukan secara otomatis berdasarkan pengaturan browser penerima.

    default
    UnSubscribeFilterLevel

    string

    No

    Tingkat pemfilteran. Untuk informasi lebih lanjut, lihat Mekanisme pembuatan dan pemfilteran tautan berhenti berlangganan. Nilai valid:

    • disabled: Tidak ada pemfilteran yang diterapkan.

    • default: Kebijakan default digunakan. Alamat batch difilter pada tingkat alamat pengirim.

    • mailfrom: Pemfilteran pada tingkat alamat pengirim.

    • mailfrom_domain: Pemfilteran pada tingkat domain pengirim.

    • edm_id: Pemfilteran pada tingkat akun.

    mailfrom_domain
    Headers

    string

    No

    Pengaturan header email.

    Bidang Jenis Penyimpanan Standar dan non-Jenis Penyimpanan Standar harus mematuhi persyaratan sintaks untuk header yang didefinisikan dalam Jenis Penyimpanan Standar. Maksimal 10 header dapat diteruskan melalui bidang headers saat mengirim email melalui API. Header yang melebihi batas ini akan diabaikan. SMTP tidak memiliki batas tersebut.

    1. Bidang Jenis Penyimpanan Standar

    Message-ID, List-Unsubscribe, List-Unsubscribe-Post

    Bidang Jenis Penyimpanan Standar menimpa nilai asli di header email.

    1. Bidang non-Jenis Penyimpanan Standar

    Tidak peka huruf besar/kecil.

    a. Bidang dengan awalan X-User- (tidak didorong ke EventBridge atau Message Service (MNS). Pembatasan ini hanya berlaku untuk API. SMTP mengizinkan bidang kustom apa pun.)

    b. Bidang dengan awalan X-User-Notify- (didorong ke EventBridge dan Message Service (MNS). API dan SMTP didukung.)

    Saat didorong ke EventBridge atau MNS, bidang ini disertakan di bawah bidang header.

    { "Message-ID": "", "X-User-UID1": "UID-1-000001", "X-User-UID2": "UID-2-000001", "X-User-Notify-UID1": "UID-3-000001", "X-User-Notify-UID2": "UID-4-000001" }
    IpPoolId

    string

    No

    ID kolam alamat IP khusus. Pengguna yang telah membeli alamat IP khusus dapat menggunakan parameter ini untuk menentukan alamat IP arah keluar untuk tugas pengiriman email ini.

    e4xxxxxe-4xx0-4xx3-8xxa-74cxxxxx1cef
    DomainAuth

    boolean

    No

    Apakah akan mengaktifkan otentikasi tingkat domain.

    Nilai valid:

    • true

    • false

    Gunakan parameter ini hanya untuk otentikasi tingkat domain. Abaikan untuk otentikasi tingkat alamat pengirim.

    1. Buat alamat domain-auth-created-by-system@example.com di konsol. Pertahankan awalan sebelum @ tetap tidak berubah dan ganti akhiran dengan nama domain Anda sendiri.

    Skenario API

    Atur AccountName ke nama domain. Penerima melihat domain-auth-created-by-system@example.com sebagai pengirim.

    Skenario SMTP

    a. Panggil operasi ModifyPWByDomain untuk mengatur kata sandi domain.

    b. Lakukan otentikasi dengan nama domain dan kata sandi yang dikonfigurasi. Teruskan alamat kustom seperti user@example.com sebagai pengirim aktual (mailfrom). Penerima melihat user@example.com sebagai pengirim.

    true
    TemplateContent

    object

    No

    Konten email kustom. Anda dapat langsung menentukan konten tanpa membuat templat terlebih dahulu. Tentukan parameter ini atau TemplateName. Jika TemplateContent dan TemplateName keduanya ditentukan, TemplateName akan diutamakan.

    Subject

    string

    No

    Subjek email.

    黑色星期五，专属折扣来袭
    HtmlBody

    string

    No

    Badan HTML email.

    Catatan: HtmlBody dan TextBody digunakan untuk jenis konten email yang berbeda. Anda harus menentukan salah satunya.

    SDK baru menggunakan Body untuk penerusan parameter dengan batas ukuran sekitar 8 MB (Java 1.4.0 dan versi lebih baru, Python3 1.4.0 dan versi lebih baru, PHP 1.4.0 dan versi lebih baru).

    全场九折，仅限今日
    TextBody

    string

    No

    Badan teks biasa email.

    Catatan: HtmlBody dan TextBody digunakan untuk jenis konten email yang berbeda. Anda harus menentukan salah satunya.

    SDK baru menggunakan Body untuk penerusan parameter dengan batas ukuran sekitar 8 MB (Java 1.4.0 dan versi lebih baru, Python3 1.4.0 dan versi lebih baru, PHP 1.4.0 dan versi lebih baru).

    全场九折，仅限今日
    Alias

    string

    No

    Nama tampilan pengirim.

    Jackie
    Receivers

    array<object>

    No

    Daftar penerima. Jumlah penerima tidak boleh melebihi 100. Tentukan parameter ini atau ReceiversName. Jika Receivers dan ReceiversName keduanya ditentukan, ReceiversName akan diutamakan.

    Contoh: [{"To":["Jackie@example.com"],"TemplateData":{"UserName":"Jackie"}},{"To":["Tom@example.com"],"TemplateData":{"UserName":"Tom"}}].

    array<object>

    No

    Detail penerima kustom.

    To

    array

    No

    Daftar penerima. Parameter ini bertipe array.

    string

    No

    Alamat email.

    Jackie@example.com
    TemplateData

    object

    No

    Parameter templat email. Parameter ini bertipe peta JSON.

    string

    No

    key-value 字符串

    {"UserName": "Jackie"}

    Elemen respons

    Element

    Type

    Description

    Example

    object

    EnvId

    string

    ID event.

    xxx
    RequestId

    string

    ID permintaan.

    12D086F6-8F31-4658-84C1-006DED011A85

    Contoh

    Respons sukses

    JSONformat

    {
  "EnvId": "xxx",
  "RequestId": "12D086F6-8F31-4658-84C1-006DED011A85"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.