AutoSend

Giới thiệu

Tích hợp AutoSend gửi email thông qua email API của AutoSend mỗi khi một sự kiện của Dodo Payments xảy ra, từ thanh toán thành công đến các lần thử thanh toán thất bại và xác nhận hoàn tiền. Một transformation trên webhook endpoint sẽ chuyển mỗi sự kiện thành một send request của AutoSend. Để thiết lập, bạn cần một AutoSend API key và một sender domain đã được xác minh trong AutoSend. Bạn có thể tìm API key trong dashboard của AutoSend, tại Settings → API Keys.

Bắt đầu

Làm theo các bước sau để kết nối AutoSend với Dodo Payments:

Open Webhook Section

Trong dashboard của Dodo Payments, đi đến Developer → Webhooks và nhấp vào Add endpoint.

Hộp thoại thêm endpoint với AutoSend được chọn trong menu thả xuống Integration

Select AutoSend Integration

Trong Integration, chọn Autosend.

Enter API Key

Trong API key, dán API key AutoSend của bạn. Dodo Payments gửi key này trong header Authorization của mỗi lần gửi.

Learn how to create and manage API keys

Xem tài liệu AutoSend để biết cách tạo và quản lý API key.

Select Events

Trong Subscribed events, chọn các sự kiện mà transformation của bạn xử lý, chẳng hạn như payment.succeeded, subscription.active và payment.failed. Endpoint không chọn sự kiện nào sẽ nhận mọi loại sự kiện.

Configure Transformation

Trong Transformation code, viết JavaScript handler để tạo email cho từng sự kiện. Bắt đầu từ các ví dụ về code.

Test & Create

Trong Test this code, nhấp vào Simulate để chạy handler với payload mẫu và kiểm tra kết quả. Sau đó nhấp vào Create endpoint.

Activation Complete

Endpoint gửi email thông qua AutoSend mỗi khi một sự kiện đã đăng ký xảy ra.

Ví dụ về code

Mỗi handler kiểm tra loại sự kiện trong webhook.eventType và đọc dữ liệu sự kiện từ webhook.payload.data. Handler đặt webhook.url thành endpoint gửi của AutoSend và thay thế webhook.payload bằng yêu cầu gửi email. Các amount của Dodo Payments, chẳng hạn như total_amount, được tính theo đơn vị tiền tệ nhỏ nhất, ví dụ như cent đối với USD.

Email xác nhận thanh toán

Gửi email xác nhận khi một khoản thanh toán thành công (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 chào mừng đăng ký

Gửi email chào mừng khi một subscription trở nên active (subscription.active). Ví dụ truyền product_id dưới dạng planName. Nếu template của bạn hiển thị tên plan, trước tiên hãy ánh xạ ID sang tên hiển thị.

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;
}

Thông báo thanh toán thất bại

Gửi email thông báo khi một khoản thanh toán thất bại (payment.failed). Trường error_message của payment chứa lý do thất bại.

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;
}

Các phương pháp hay nhất

Xác minh domain gửi: AutoSend chỉ gửi từ domain đã được xác minh, vì vậy hãy xác minh domain của địa chỉ from trong AutoSend trước khi tạo endpoint. Domain đã được xác minh cũng cải thiện khả năng gửi email thành công và giúp email không bị đưa vào thư mục spam.
Sử dụng dữ liệu động để cá nhân hóa: Truyền các giá trị riêng của khách hàng, chẳng hạn như tên, amount thanh toán và thông tin subscription, trong trường dynamicData, rồi tham chiếu chúng dưới dạng biến trong template AutoSend.
Viết tiêu đề rõ ràng: Viết tiêu đề nêu rõ mục đích của email. Tránh các từ kích hoạt bộ lọc spam và giữ tiêu đề dưới 50 ký tự.
Kiểm tra trước khi production: Chạy từng handler bằng Test this code, sau đó gửi email kiểm thử trước khi đưa vào hoạt động. Kiểm tra để đảm bảo nội dung hiển thị chính xác và mọi giá trị dynamicData đều đã được ánh xạ.

Tài liệu tham khảo API

Để xem mọi parameter và error code của endpoint gửi, hãy xem tài liệu API AutoSend.

Khắc phục sự cố

Emails Not Being Sent

Xác minh API key chính xác và đang hoạt động.
Kiểm tra domain gửi đã được xác minh trong AutoSend.
Kiểm tra địa chỉ email người nhận hợp lệ.
Xem lại các giới hạn và hạn mức gửi của AutoSend.
Xác minh transformation đặt URL endpoint gửi: https://api.autosend.com/v1/mails/send.
Kiểm tra payload bao gồm mọi parameter bắt buộc.
Mở các lần gửi của endpoint trong tab Logs của Developer → Webhooks để xem response code của AutoSend.

Transformation Errors

Kiểm tra payload khớp với định dạng API AutoSend.
Kiểm tra tất cả field bắt buộc đều có mặt: to, from và templateId hoặc html/text. Nếu không có templateId, subject cũng là bắt buộc.
Kiểm tra địa chỉ email được định dạng chính xác.
Nếu sử dụng template, xác minh templateId hợp lệ.
Kiểm tra các key dynamicData khớp với các biến trong template.

Template Issues

Xác minh template ID chính xác và template đang active trong AutoSend.
Kiểm tra các key dynamicData khớp với các biến trong template.
Kiểm tra mọi template variable bắt buộc đều có giá trị.
Kiểm tra template riêng trong dashboard AutoSend.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Giới thiệu

Bắt đầu

Learn how to create and manage API keys

Ví dụ về code

Email xác nhận thanh toán

Email chào mừng đăng ký

Thông báo thanh toán thất bại

Các phương pháp hay nhất

Tài liệu tham khảo API

Khắc phục sự cố

​Giới thiệu

​Bắt đầu

Learn how to create and manage API keys

​Ví dụ về code

​Email xác nhận thanh toán

​Email chào mừng đăng ký

​Thông báo thanh toán thất bại

​Các phương pháp hay nhất

​Tài liệu tham khảo API

​Khắc phục sự cố

Giới thiệu

Bắt đầu

Ví dụ về code

Email xác nhận thanh toán

Email chào mừng đăng ký

Thông báo thanh toán thất bại

Các phương pháp hay nhất

Tài liệu tham khảo API

Khắc phục sự cố