AutoSend

Pendahuluan

Integrasi AutoSend mengirimkan email melalui email API AutoSend setiap kali peristiwa Dodo Payments terjadi, mulai dari pembayaran berhasil hingga percobaan pembayaran gagal dan konfirmasi pengembalian dana. Transformasi pada endpoint webhook mengubah setiap peristiwa menjadi permintaan pengiriman AutoSend. Untuk menyiapkannya, Anda memerlukan kunci API AutoSend dan domain pengirim yang telah diverifikasi di AutoSend. Anda dapat menemukan kunci API di dasbor AutoSend, di Settings → API Keys.

Memulai

Ikuti langkah-langkah berikut untuk menghubungkan AutoSend ke Dodo Payments:

Open Webhook Section

Di dasbor Dodo Payments, buka Developer → Webhooks dan klik Add endpoint.

Dialog penambahan endpoint dengan AutoSend dipilih di dropdown Integration

Select AutoSend Integration

Di Integration, pilih Autosend.

Enter API Key

Di API key, tempel API key AutoSend Anda. Dodo Payments mengirimkannya di header Authorization pada setiap delivery.

Learn how to create and manage API keys

Lihat dokumentasi AutoSend untuk mengetahui cara membuat dan mengelola API key.

Select Events

Di Subscribed events, pilih event yang ditangani transformation Anda, seperti payment.succeeded, subscription.active, dan payment.failed. Endpoint tanpa event yang dipilih akan menerima semua jenis event.

Configure Transformation

Di bawah Transformation code, tulis handler JavaScript yang menyusun email untuk setiap event. Mulai dari contoh kode.

Test & Create

Di bawah Test this code, klik Simulate untuk menjalankan handler terhadap payload contoh dan memeriksa hasilnya. Lalu klik Create endpoint.

Activation Complete

Endpoint mengirim email melalui AutoSend setiap kali event yang dipilih terjadi.

Contoh Kode

Setiap handler memeriksa jenis event di webhook.eventType dan membaca data event dari webhook.payload.data. Handler menetapkan webhook.url ke endpoint pengiriman AutoSend dan mengganti webhook.payload dengan permintaan email. Jumlah Dodo Payments, seperti total_amount, menggunakan unit mata uang terkecil, misalnya sen untuk USD.

Email Konfirmasi Pembayaran

Kirim email konfirmasi saat pembayaran berhasil (payment.succeeded):

payment_confirmation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "payments@mail.yourdomain.com",
        name: "Your Company",
      },
      subject: "Payment Successful - Thank you for your purchase!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.total_amount,
        currency: p.currency,
        paymentId: p.payment_id,
        paymentDate: new Date(p.created_at).toLocaleDateString(),
      },
      replyTo: {
        email: "support@yourdomain.com",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

Email Sambutan Langganan

Kirim email sambutan saat langganan menjadi aktif (subscription.active). Contoh ini meneruskan product_id sebagai planName. Jika template Anda menampilkan nama paket, petakan ID ke nama tampilan terlebih dahulu.

subscription_welcome.js

function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: s.customer.email,
        name: s.customer.name,
      },
      from: {
        email: "subscriptions@mail.yourdomain.com",
        name: "Your Company",
      },
      subject: "Welcome to your subscription!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: s.customer.name,
        planName: s.product_id,
        billingInterval: s.payment_frequency_interval,
        nextBillingDate: new Date(s.next_billing_date).toLocaleDateString(),
        subscriptionId: s.subscription_id,
      },
      replyTo: {
        email: "support@yourdomain.com",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

Notifikasi Kegagalan Pembayaran

Kirim email notifikasi saat pembayaran gagal (payment.failed). Field error_message pada pembayaran berisi alasan kegagalan.

payment_failure.js

function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "billing@mail.yourdomain.com",
        name: "Your Company Billing",
      },
      subject: "Payment Failed - Action Required",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.total_amount,
        currency: p.currency,
        failureReason: p.error_message,
        paymentId: p.payment_id,
        retryUrl: `https://yourdomain.com/billing/retry/${p.payment_id}`,
      },
      replyTo: {
        email: "billing@yourdomain.com",
        name: "Billing Support",
      },
    };
  }
  return webhook;
}

Praktik Terbaik

Verifikasi domain pengirim Anda: AutoSend hanya mengirim dari domain yang telah diverifikasi, jadi verifikasi domain alamat from Anda di AutoSend sebelum membuat endpoint. Domain yang telah diverifikasi juga meningkatkan deliverability dan membantu menjaga email Anda agar tidak masuk folder spam.
Gunakan data dinamis untuk personalisasi: Teruskan nilai khusus pelanggan, seperti nama, jumlah pembayaran, dan detail langganan, di field dynamicData, lalu referensikan nilai tersebut sebagai variabel di template AutoSend Anda.
Tulis baris subjek yang jelas: Tulis baris subjek yang menyatakan tujuan email. Hindari kata-kata yang memicu filter spam, dan jaga agar subjek tidak lebih dari 50 karakter.
Uji sebelum produksi: Jalankan setiap handler dengan Test this code, lalu kirim email uji sebelum mulai digunakan. Periksa apakah konten ditampilkan dengan benar dan setiap nilai dynamicData telah dipetakan.

Referensi API

Untuk setiap parameter dan kode error endpoint pengiriman, lihat dokumentasi API AutoSend.

Pemecahan Masalah

Emails Not Being Sent

Pastikan API key sudah benar dan aktif.
Pastikan domain pengirim telah diverifikasi di AutoSend.
Pastikan alamat email penerima valid.
Tinjau batas pengiriman dan kuota AutoSend Anda.
Pastikan transformation menetapkan URL endpoint pengiriman: https://api.autosend.com/v1/mails/send.
Pastikan payload mencakup setiap parameter yang diperlukan.
Buka delivery attempts endpoint di tab Logs pada Developer → Webhooks untuk melihat kode respons AutoSend.

Transformation Errors

Pastikan payload sesuai dengan format API AutoSend.
Pastikan semua field yang diperlukan tersedia: to, from, dan salah satu dari templateId atau html/text. Tanpa templateId, subject juga diperlukan.
Pastikan alamat email diformat dengan benar.
Jika Anda menggunakan template, pastikan templateId valid.
Pastikan key dynamicData cocok dengan variabel template Anda.

Template Issues

Pastikan ID template sudah benar dan template aktif di AutoSend.
Pastikan key dynamicData cocok dengan variabel di template Anda.
Pastikan setiap variabel template yang diperlukan memiliki nilai.
Uji template secara terpisah di dashboard AutoSend.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Pendahuluan

Memulai

Learn how to create and manage API keys

Contoh Kode

Email Konfirmasi Pembayaran

Email Sambutan Langganan

Notifikasi Kegagalan Pembayaran

Praktik Terbaik

Referensi API

Pemecahan Masalah

​Pendahuluan

​Memulai

Learn how to create and manage API keys

​Contoh Kode

​Email Konfirmasi Pembayaran

​Email Sambutan Langganan

​Notifikasi Kegagalan Pembayaran

​Praktik Terbaik

​Referensi API

​Pemecahan Masalah

Pendahuluan

Memulai

Contoh Kode

Email Konfirmasi Pembayaran

Email Sambutan Langganan

Notifikasi Kegagalan Pembayaran

Praktik Terbaik

Referensi API

Pemecahan Masalah