Slack

Giới thiệu

Tích hợp Dodo Payments với Slack cho phép bạn nhận thông báo thời gian thực về các khoản thanh toán của mình trực tiếp trong không gian làm việc Slack. Tích hợp này giúp bạn cập nhật tình trạng của các khoản thanh toán, theo dõi giao dịch và quản lý các khoản thanh toán của mình một cách hiệu quả hơn.

Tích hợp này sử dụng cổng quản lý webhook của chúng tôi để tự động chuyển đổi các sự kiện webhook của Dodo Payments thành các thông báo tương thích với Slack. Không cần lập trình bổ sung — chỉ cần cấu hình bộ kết nối và bắt đầu nhận thông báo.

Bắt đầu

Open the Webhook Section

Truy cập phần Webhook trong bảng điều khiển Dodo Payments của bạn. Nhấp vào nút + Add Endpoint, sau đó mở trình đơn thả xuống webhook để hiển thị các tích hợp khác.

Dodo Payments dashboard showing Add Endpoint button and integrations dropdown

Select Slack Integration

Chọn tích hợp Slack và nhấp vào Connect your Slack workspace.

Slack integration card and connect button

Grant Slack Permissions

Cấp các quyền cần thiết cho Ứng dụng Slack Incoming Webhooks để nó có thể đăng tin nhắn vào kênh bạn chọn.

Slack OAuth permissions screen for Incoming Webhooks app

Customize Transformation Code

Thêm hoặc chỉnh sửa mã biến đổi để tùy chỉnh thông báo Slack phù hợp với trường hợp sử dụng của bạn. Bạn có thể sử dụng các mẫu có sẵn hoặc tự viết logic riêng.

Transformation code editor for Slack integration

Test and Create

Kiểm tra mã biến đổi của bạn bằng các payload sự kiện tùy chỉnh hoặc có sẵn. Khi đã hài lòng, nhấp Create để kích hoạt tích hợp.

Integration Complete!

🎉 Bạn đã tạo thành công tích hợp Slack! Các sự kiện Dodo Payments giờ sẽ được gửi đến kênh Slack bạn chọn theo thời gian thực.

Ví Dụ Mã Chuyển Đổi

Thông Báo Thanh Toán Cơ Bản

Chuyển đổi này gửi các tin nhắn văn bản đơn giản cho các sự kiện thanh toán:

payment_notifs.js

function handler(webhook) {
  switch (webhook.eventType) {
    case "payment.succeeded":
      webhook.payload = {
        text: `✅ Payment Successful\nAmount: $${(webhook.payload.data.total_amount / 100).toFixed(2)}\nCustomer: ${webhook.payload.data.customer.email}\nPayment ID: ${webhook.payload.data.payment_id}`
      };
      break;
      
    case "payment.failed":
      webhook.payload = {
        text: `❌ Payment Failed\nAmount: $${(webhook.payload.data.total_amount / 100).toFixed(2)}\nCustomer: ${webhook.payload.data.customer.email}\nReason: ${webhook.payload.data.error_message || 'Unknown'}`
      };
      break;
      
    case "payment.processing":
      webhook.payload = {
        text: `⏳ Payment Processing\nAmount: $${(webhook.payload.data.total_amount / 100).toFixed(2)}\nCustomer: ${webhook.payload.data.customer.email}`
      };
      break;
  }

  return webhook;
}

Thông Báo Đăng Ký Đầy Đủ

Chuyển đổi này tạo ra các tin nhắn Slack phong phú với các tệp đính kèm cho các sự kiện đăng ký:

subscription_notifs.js

function handler(webhook) {
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        attachments: [{
          color: "good",
          title: "🎉 Subscription Activated",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Amount",
              value: `$${(webhook.payload.data.recurring_pre_tax_amount / 100).toFixed(2)}/${webhook.payload.data.payment_frequency_interval}`,
              short: true
            },
            {
              title: "Next Billing",
              value: new Date(webhook.payload.data.next_billing_date).toLocaleDateString(),
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "subscription.cancelled":
      webhook.payload = {
        attachments: [{
          color: "warning",
          title: "⚠️ Subscription Cancelled",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Cancellation Date",
              value: new Date(webhook.payload.data.cancelled_at).toLocaleDateString(),
              short: true
            },
            {
              title: "Cancel at Next Billing",
              value: webhook.payload.data.cancel_at_next_billing_date ? "Yes" : "No",
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "subscription.renewed":
      webhook.payload = {
        attachments: [{
          color: "good",
          title: "🔄 Subscription Renewed",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Amount",
              value: `$${(webhook.payload.data.recurring_pre_tax_amount / 100).toFixed(2)}`,
              short: true
            },
            {
              title: "Next Billing",
              value: new Date(webhook.payload.data.next_billing_date).toLocaleDateString(),
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
  }

  return webhook;
}

Thông Báo Quản Lý Tranh Chấp

Chuyển đổi này xử lý các sự kiện tranh chấp với màu sắc và độ khẩn cấp phù hợp:

dispute_notifs.js

function handler(webhook) {
  switch (webhook.eventType) {
    case "dispute.opened":
      webhook.payload = {
        attachments: [{
          color: "danger",
          title: "🚨 New Dispute Opened",
          fields: [
            {
              title: "Payment ID",
              value: webhook.payload.data.payment_id,
              short: true
            },
            {
              title: "Amount",
              value: `$${(webhook.payload.data.amount / 100).toFixed(2)}`,
              short: true
            },
            {
              title: "Status",
              value: webhook.payload.data.dispute_status,
              short: true
            },
            {
              title: "Stage",
              value: webhook.payload.data.dispute_stage,
              short: true
            },
            {
              title: "Remarks",
              value: webhook.payload.data.remarks || "No remarks",
              short: false
            }
          ],
          footer: "Dodo Payments - Action Required",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "dispute.won":
      webhook.payload = {
        attachments: [{
          color: "good",
          title: "✅ Dispute Won",
          fields: [
            {
              title: "Payment ID",
              value: webhook.payload.data.payment_id,
              short: true
            },
            {
              title: "Amount",
              value: `$${(webhook.payload.data.amount / 100).toFixed(2)}`,
              short: true
            },
            {
              title: "Status",
              value: webhook.payload.data.dispute_status,
              short: true
            },
            {
              title: "Resolution",
              value: "Dispute resolved in your favor",
              short: false
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "dispute.lost":
      webhook.payload = {
        attachments: [{
          color: "danger",
          title: "❌ Dispute Lost",
          fields: [
            {
              title: "Payment ID",
              value: webhook.payload.data.payment_id,
              short: true
            },
            {
              title: "Amount",
              value: `$${(webhook.payload.data.amount / 100).toFixed(2)}`,
              short: true
            },
            {
              title: "Status",
              value: webhook.payload.data.dispute_status,
              short: true
            },
            {
              title: "Impact",
              value: "Funds will be debited from your account",
              short: false
            }
          ],
          footer: "Dodo Payments - Review Required",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
  }

  return webhook;
}

Trình Xử Lý Tất Cả Các Sự Kiện Toàn Diện

Chuyển đổi này xử lý tất cả các loại sự kiện với định dạng nhất quán:

all_events_notifs.js

function handler(webhook) {
  const event = webhook.payload.data;
  const timestamp = new Date(webhook.payload.timestamp).toLocaleString();
  
  let color, emoji, title, fields = [];
  
  switch (webhook.eventType) {
    case "payment.succeeded":
      color = "good";
      emoji = "✅";
      title = "Payment Successful";
      fields = [
        { title: "Amount", value: `$${(event.total_amount / 100).toFixed(2)}`, short: true },
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Method", value: event.payment_method || "Unknown", short: true }
      ];
      break;
      
    case "payment.failed":
      color = "danger";
      emoji = "❌";
      title = "Payment Failed";
      fields = [
        { title: "Amount", value: `$${(event.total_amount / 100).toFixed(2)}`, short: true },
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Reason", value: event.error_message || "Unknown", short: false }
      ];
      break;
      
    case "subscription.active":
      color = "good";
      emoji = "🎉";
      title = "Subscription Activated";
      fields = [
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "Amount", value: `$${(event.recurring_pre_tax_amount / 100).toFixed(2)}/${event.payment_frequency_interval}`, short: true },
        { title: "Next Billing", value: new Date(event.next_billing_date).toLocaleDateString(), short: true }
      ];
      break;
      
    case "subscription.cancelled":
      color = "warning";
      emoji = "⚠️";
      title = "Subscription Cancelled";
      fields = [
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "Cancellation Date", value: new Date(event.cancelled_at).toLocaleDateString(), short: true },
        { title: "Cancel at Next Billing", value: event.cancel_at_next_billing_date ? "Yes" : "No", short: true }
      ];
      break;
      
    case "refund.succeeded":
      color = "good";
      emoji = "💰";
      title = "Refund Processed";
      fields = [
        { title: "Amount", value: `$${(event.amount / 100).toFixed(2)}`, short: true },
        { title: "Refund ID", value: event.refund_id, short: true },
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Reason", value: event.reason || "Not specified", short: true }
      ];
      break;
      
    case "dispute.opened":
      color = "danger";
      emoji = "🚨";
      title = "New Dispute Opened";
      fields = [
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Amount", value: `$${(event.amount / 100).toFixed(2)}`, short: true },
        { title: "Status", value: event.dispute_status, short: true },
        { title: "Stage", value: event.dispute_stage, short: true },
        { title: "Remarks", value: event.remarks || "No remarks", short: false }
      ];
      break;
      
    case "license_key.created":
      color = "good";
      emoji = "🔑";
      title = "License Key Created";
      fields = [
        { title: "License ID", value: event.id, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "License Key", value: event.key.substring(0, 8) + "...", short: true },
        { title: "Expires", value: event.expires_at ? new Date(event.expires_at).toLocaleDateString() : "Never", short: true }
      ];
      break;
      
    default:
      // Handle any other events with a generic format
      color = "warning";
      emoji = "ℹ️";
      title = webhook.eventType.replace(/_/g, ' ').replace(/\b\w/g, l => l.toUpperCase());
      fields = [
        { title: "Event Type", value: webhook.eventType, short: true },
        { title: "Timestamp", value: timestamp, short: true }
      ];
  }
  
  webhook.payload = {
    attachments: [{
      color: color,
      title: `${emoji} ${title}`,
      fields: fields,
      footer: "Dodo Payments",
      ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
    }]
  };

  return webhook;
}

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

Để các thông báo Slack của bạn trở nên hiệu quả:

Sử dụng tệp đính kèm tin nhắn phong phú với màu sắc, trường và định dạng để đảm bảo tính rõ ràng và khả năng hành động.
Luôn bao gồm các dữ liệu quan trọng như số tiền, email khách hàng và ID để nhanh chóng xác định.
Chọn màu sắc phù hợp với loại sự kiện: xanh lá cây (good) cho thành công, đỏ (danger) cho tranh chấp hoặc lỗi, vàng (warning) cho hủy và xanh dương (#3aa3e3) cho các sự kiện cung cấp thông tin.
Thêm dấu thời gian để dễ theo dõi thời điểm mỗi sự kiện xảy ra.

Xử lý Dữ liệu Nhạy cảm: Hãy cẩn thận không đưa thông tin nhạy cảm như khóa giấy phép đầy đủ hoặc dữ liệu cá nhân vào các tin nhắn Slack. Hãy cân nhắc việc cắt ngắn hoặc che mặt các giá trị nhạy cảm.

Khắc Phục Sự Cố

Notifications not appearing in Slack

Xác minh rằng URL webhook Slack là chính xác và đang hoạt động
Kiểm tra xem mã biến đổi có phải là JavaScript hợp lệ không
Đảm bảo các loại sự kiện đã chọn đang được kích hoạt
Xác nhận rằng ứng dụng Slack của bạn có các quyền cần thiết

Transformation errors

Kiểm tra cổng quản lý webhook để xem nhật ký lỗi biến đổi
Xác minh rằng cấu trúc payload webhook phù hợp với mã biến đổi của bạn
Thử nghiệm mã biến đổi với dữ liệu mẫu
Đảm bảo tất cả các trường bắt buộc đều có trong payload webhook

Missing event types

Xác nhận rằng các sự kiện bạn muốn nhận đã được bật trong cấu hình webhook Dodo Payments
Kiểm tra rằng các loại sự kiện đã được chọn trong cấu hình bộ kết nối Slack
Xác minh rằng endpoint của bạn được cấu hình đúng để nhận các sự kiện

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Giới thiệu

Bắt đầu

Ví Dụ Mã Chuyển Đổi

Thông Báo Thanh Toán Cơ Bản

Thông Báo Đăng Ký Đầy Đủ

Thông Báo Quản Lý Tranh Chấp

Trình Xử Lý Tất Cả Các Sự Kiện Toàn Diện

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

Khắc Phục Sự Cố

​Giới thiệu

​Bắt đầu

​Ví Dụ Mã Chuyển Đổi

​Thông Báo Thanh Toán Cơ Bản

​Thông Báo Đăng Ký Đầy Đủ

​Thông Báo Quản Lý Tranh Chấp

​Trình Xử Lý Tất Cả Các Sự Kiện Toàn Diện

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

​Khắc Phục Sự Cố

Giới thiệu

Bắt đầu

Ví Dụ Mã Chuyển Đổi

Thông Báo Thanh Toán Cơ Bản

Thông Báo Đăng Ký Đầy Đủ

Thông Báo Quản Lý Tranh Chấp

Trình Xử Lý Tất Cả Các Sự Kiện Toàn Diện

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

Khắc Phục Sự Cố