Chuyển đến nội dung chính

Giới thiệu

Tích hợp AutoSend và Dodo Payments cho phép bạn tự động gửi thông báo email theo thời gian thực cho tất cả các sự kiện thanh toán, từ các giao dịch thành công đến các nỗ lực không thành công và xác nhận hoàn tiền. Gửi email giao dịch cho các sự kiện thanh toán bằng API email mạnh mẽ của AutoSend.
Tích hợp này yêu cầu Khóa API AutoSend của bạn để xác thực. Bạn có thể tìm khóa API trong bảng điều khiển AutoSend tại Cài đặt > Khóa API.

Bắt đầu

Thực hiện các bước sau để tích hợp AutoSend với Dodo Payments:
1

Open Webhook Section

Điều hướng đến mục Webhooks trong bảng điều khiển Dodo Payments của bạn.
Add Endpoint and integrations dropdown
2

Select AutoSend Integration

Chọn AutoSend từ danh sách các tích hợp có sẵn.
3

Enter API Key

Cung cấp khóa API AutoSend của bạn để xác thực. Bạn có thể tìm khóa API trong bảng điều khiển AutoSend tại Cài đặt > Khóa API.

Learn how to create and manage API keys

Truy cập tài liệu AutoSend để biết hướng dẫn chi tiết về cách tạo và quản lý khóa API.
4

Configure Transformation

Thiết lập các bộ xử lý chuyển đổi JavaScript để tùy chỉnh nội dung email dựa trên sự kiện thanh toán.
5

Test & Create

Kiểm tra cấu hình webhook để đảm bảo email được gửi đúng cách, sau đó tạo tích hợp.
6

Activation Complete

🎉 Tích hợp AutoSend của bạn hiện đang hoạt động và sẽ tự động gửi email cho các sự kiện thanh toán được cấu hình.

Ví dụ Mã

Email Xác Nhận Thanh Toán

Gửi email xác nhận khi một khoản thanh toán được xử lý thành công:
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.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 đăng ký mới được tạo:
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.plan.name,
        billingInterval: s.billing_interval,
        nextBillingDate: new Date(s.next_billing_at).toLocaleDateString(),
        subscriptionId: s.subscription_id,
      },
      replyTo: {
        email: "support@yourdomain.com",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

Thông Báo Thất Bại Thanh Toán

Gửi email thông báo khi một khoản thanh toán 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.amount,
        currency: p.currency,
        failureReason: p.failure_reason,
        paymentId: p.payment_id,
        retryUrl: `https://yourdomain.com/billing/retry/${p.payment_id}`,
      },
      replyTo: {
        email: "billing@yourdomain.com",
        name: "Billing Support",
      },
    };
  }
  return webhook;
}

Thực Hành Tốt Nhất

  • Xác minh miền gửi của bạn: Đảm bảo miền email gửi của bạn đã được xác minh trong AutoSend để cải thiện khả năng gửi và tránh các vấn đề xác thực. Các miền đã được xác minh giúp ngăn chặn email rơi vào thư mục spam.
  • Sử dụng dữ liệu động để cá nhân hóa: Sử dụng trường dynamicData để cá nhân hóa email với thông tin cụ thể của khách hàng như tên, số tiền thanh toán và thông tin đăng ký. Email cá nhân hóa có tỷ lệ tương tác cao hơn.
  • Viết tiêu đề rõ ràng: Viết tiêu đề mô tả rõ ràng chỉ ra mục đích của email. Tránh các từ kích hoạt spam và giữ cho tiêu đề ngắn gọn (dưới 50 ký tự).
  • Kiểm tra trước khi sản xuất: Luôn kiểm tra email của bạn trước khi gửi chúng trong sản xuất. Điều này đảm bảo nội dung email của bạn hiển thị đúng cách và tất cả dữ liệu động được ánh xạ chính xác.

Tài Liệu API

Để biết chi tiết đầy đủ về API AutoSend, bao gồm tất cả các tham số và mã lỗi có sẵn, hãy truy cập Tài liệu API AutoSend.

Khắc Phục Sự Cố

  • Xác minh Khóa API đúng và đang hoạt động
  • Kiểm tra xem miền gửi có được xác minh trong AutoSend không
  • Đảm bảo địa chỉ email người nhận hợp lệ
  • Xem xét giới hạn và hạn mức gửi của AutoSend
  • Xác minh URL điểm cuối API đúng: https://api.autosend.com/v1/mails/send
  • Kiểm tra xem các tham số bắt buộc đã có trong payload chưa
  • Xác thực cấu trúc JSON khớp định dạng API AutoSend
  • Kiểm tra xem tất cả trường bắt buộc đã có (to, from, templateId hoặc html/text)
  • Đảm bảo địa chỉ email được định dạng đúng
  • Xác minh templateId hợp lệ nếu sử dụng mẫu
  • Kiểm tra rằng các khóa dynamicData khớp với biến trong mẫu của bạn
  • Xác minh ID mẫu của bạn đúng và đang hoạt động trong AutoSend
  • Đảm bảo các khóa dynamicData khớp với các biến được sử dụng trong mẫu
  • Kiểm tra rằng tất cả biến mẫu bắt buộc đã được cung cấp
  • Thử nghiệm mẫu của bạn độc lập trong bảng điều khiển AutoSend