Pertanyaan yang sering diajukan

Halaman ini menjawab pertanyaan umum tentang integrasi dan penelusuran masalah. Lihat panduan terkait untuk protokol lengkap tanpa mengulang setiap tabel parameter.

Sebelum memulai

Siapkan Message ID lengkap, waktu permintaan, status HTTP, dan code respons. Untuk masalah Webhook, sertakan juga eventId. Jangan mencantumkan rahasia asli dalam tiket dukungan atau log.

Integrasi dan autentikasi

Di mana saya mendapatkan AppID dan AppSecret?

Kelola kredensial API melalui Console > Developers di konsol platform utama. AppID adalah API Key lengkap. AppSecret digunakan untuk menghitung CheckSum dan juga sebagai password SMTP. Simpan hanya di server dan segera rotasi jika terekspos. Lihat Memulai.

Apa yang harus diperiksa saat HTTP 401 atau kegagalan tanda tangan?

• Apakah AppID dan API Secret cocok serta kredensial masih aktif;
• Apakah Nonce dibuat baru untuk setiap percobaan HTTP;
• Apakah CurTime adalah timestamp Unix saat ini dalam detik dan berada dalam jendela yang diizinkan;
• Apakah CheckSum berupa 40 karakter hex huruf besar dari SHA1(AppSecret + Nonce + CurTime);
• Apakah parameter Bearer dan tanda tangan dicampur sehingga mode autentikasi lain didahulukan;
• Apakah IP egress memenuhi allowlist API Key.

Untuk error autentikasi, periksa 020001, 020002, 020008, dan 020009. Lihat error API pengiriman.

Apakah Nonce dan kunci idempotensi harus diubah saat mencoba ulang?

Dengan CheckSum, buat Nonce, CurTime, dan CheckSum baru untuk setiap percobaan HTTP, tetapi pertahankan X-Idempotency-Key dan body permintaan. Hasil idempotensi disimpan selama 24 jam secara default, bergantung pada lingkungan. Kunci kedaluwarsa bukan perlindungan duplikasi jangka panjang.

Pengiriman dan hasil

Mengapa respons API berhasil tetapi email tidak terkirim?

Keberhasilan berarti penerimaan: HTTP 202 dengan code=000000. Kegagalan berikutnya dapat berupa template tidak tersedia, domain tidak diotorisasi, supresi, penolakan kanal, atau bounce.

Cari Catatan Pengiriman berdasarkan Message ID lengkap. Delivered berarti server penerima menerima pesan, belum tentu masuk kotak masuk; periksa juga spam dan kebijakan sisi penerima. Lihat Catatan dan status pengiriman.

Apakah beberapa alamat yang salah memengaruhi seluruh batch?

Ada dua tahap:

1. Sebelum penerimaan: jika satu objek pesan gagal validasi permintaan atau bisnis, seluruh batch ditolak dan tidak ada item yang diterima.
2. Setelah penerimaan: setiap pesan diproses secara independen dan dapat memiliki hasil akhir berbeda.

Untuk pesan transaksional, beberapa alamat salah format dapat muncul dalam invalidRecipients sebagai pemeriksaan awal. Ini bukan daftar kegagalan akhir. Lihat Pengiriman tunggal dan batch.

Dapatkah kampanye yang telah diajukan ditarik kembali?

Pengajuan review tidak sama dengan pengiriman. Kampanye menunggu review atau terjadwal yang belum dijalankan dapat dibatalkan jika tersedia di halaman. Kampanye yang sudah dalam alur pengiriman tidak dapat ditarik kembali. Uji terlebih dahulu dan mulai dengan audiens kecil. Lihat Operasi konsol.

Mengapa batch di bawah 100 item masih terkena batas laju?

100 adalah batas item per batch, bukan laju akun. Setiap item menggunakan kapasitas jendela TPS dan kuota harian API Key, dan kapasitas yang tidak mencukupi menolak seluruh batch. Kuota harian berubah pada UTC 00:00 (08:00 waktu Beijing).

Domain dan berhenti berlangganan

Berapa lama verifikasi atau review domain?

Propagasi DNS bergantung pada TTL dan cache, sedangkan review manual memerlukan pemrosesan platform. Tidak ada durasi tetap yang universal. Konfigurasikan catatan aktual di halaman detail dan segarkan.

Tunggu hingga verifikasi domain selesai. Jika halaman detail memerlukan review, ajukan dan tunggu keputusan platform. Saran DMARC dapat bersifat opsional, jadi jangan menganggap “SPF, DKIM, dan DMARC semuanya terverifikasi” sebagai prasyarat pengajuan universal. Lihat Domain pengirim dan verifikasi identitas.

Dapatkah supresi yang dihapus muncul kembali?

Ya. Event hard bounce atau event serupa berikutnya dapat membuat catatan penghentian pengiriman baru. Selesaikan kesalahan alamat, keluhan, atau pemblokiran sisi penerima sebelum menghapus catatan; penghapusan bukan cara menghindari berhenti berlangganan atau keluhan. Lihat Email pemasaran dan berhenti berlangganan.

Bagaimana mengubah pengaturan berhenti berlangganan otomatis, Webhook, atau kuota?

Ini adalah pengaturan tingkat API Key atau tenant yang dikelola operator platform. Pelanggan dapat menyesuaikan merek dan teks tiga bahasa di Pengaturan Halaman Berhenti Berlangganan, tetapi itu tidak mengaktifkan sakelar otomatis API Key atau mengubah pengaturan Webhook dan kuota.

Webhook

Mengapa saya tidak menerima event yang telah dikonfigurasi?

Periksa apakah:

• Callback dapat diakses publik melalui HTTPS dengan sertifikat valid;
• DNS mengarah ke alamat privat atau cadangan yang ditolak;
• Tipe event yang benar-benar terjadi telah dilanggan;
• Endpoint mengembalikan 2xx dalam 10 detik;
• Mode tanda tangan, satuan timestamp, raw body, dan encoding tanda tangan sudah benar;
• Pelacakan buka dan klik didukung oleh kanal saat ini.

Platform tidak mencoba ulang secara otomatis atau menjamin replay setelah kegagalan. Rekonsiliasi dengan catatan pengiriman dan hubungi operator platform dengan Message ID serta eventId. Lihat Webhook event.

Bagaimana jika event yang sama diterima lebih dari sekali?

Simpan dan deduplikasi berdasarkan eventId dalam body; satu Message ID dapat memiliki beberapa tipe event yang sah. Jangan bergantung pada penjelasan lama “pasangan CB- dan CBRT-” atau mengharapkan respons non-2xx memicu percobaan ulang otomatis.

Kemampuan lainnya

Apakah SMTP, email masuk, dan penerusan didukung?

Pengiriman SMTP didukung. Konsol menampilkan smtp.innomails.com:587 dengan STARTTLS. Username adalah API Key dan password adalah API Secret terkait; tidak ada password SMTP terpisah.

Email masuk, kotak surat IMAP/POP3, dan penerusan saat ini tidak disediakan. IMAP dan POP3 mengambil email dari kotak surat yang sudah ada; keduanya bukan antarmuka pengiriman Produk Email.

Apakah unggahan dan pengiriman lampiran didukung?

Tidak ada unggahan lampiran atau penyimpanan konten yang dapat digunakan. Referensi lampiran dalam model permintaan tidak berarti lampiran akan dikirim; abaikan attachments. Lihat Template dan variabel untuk kemampuan isi dan template.

Sumber terkait