Microsoft Teams

Pendahuluan

Integrasi Microsoft Teams memposting event Dodo Payments ke channel Teams sebagai Adaptive Cards, sehingga tim Anda dapat melihat pembayaran, perubahan langganan, dan sengketa saat terjadi. Gunakan integrasi ini jika Teams adalah tempat tim bisnis Anda bekerja.

Panduan ini mengasumsikan Anda memiliki akses admin untuk membuat webhook di ruang kerja Microsoft Teams Anda.

Memulai

Open the Webhook Section

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

Add endpoint dialog with Teams selected in the Integration dropdown

Select Microsoft Teams

Dalam daftar Integration, pilih Teams.

Create Teams Webhook

Microsoft menghentikan konektor Incoming Webhook Office 365 di Teams, jadi buat webhook dengan aplikasi Workflows:

Di Teams, buka channel yang akan menerima notifikasi.
Klik ⋯ di samping nama channel, lalu pilih Workflows.
Pilih template Post to a channel when a webhook request is received.
Konfirmasikan team dan channel, lalu klik Add workflow.
Salin URL webhook yang ditampilkan Teams.

Paste Webhook URL

Tempel URL webhook Teams ke kolom Endpoint URL.

Customize Transformation

Edit kode di bawah Transformation code untuk memformat setiap event sebagai Adaptive Card. Mulai dari contoh di bawah.

Test & Create

Di bawah Test this code, jalankan transformasi terhadap payload sampel, lalu klik Create endpoint.

Done

Channel Teams Anda kini menerima event Dodo Payments sebagai Adaptive Cards.

Contoh Kode Transformasi

Setiap contoh mengganti payload event dengan pesan Teams yang membawa satu lampiran Adaptive Card.

Kartu Pembayaran Dasar

Contoh ini memposting jumlah, email pelanggan, dan ID pembayaran saat pembayaran berhasil.

payment_card.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.payload = {
      type: "message",
      attachments: [{
        contentType: "application/vnd.microsoft.card.adaptive",
        content: {
          type: "AdaptiveCard",
          body: [
            {
              type: "TextBlock",
              text: "✅ Payment Successful",
              weight: "Bolder",
              size: "Medium"
            },
            {
              type: "FactSet",
              facts: [
                { title: "Amount", value: `$${(p.total_amount / 100).toFixed(2)}` },
                { title: "Customer", value: p.customer.email },
                { title: "Payment ID", value: p.payment_id }
              ]
            }
          ]
        }
      }]
    };
  }
  return webhook;
}

Manajemen Langganan

Contoh ini memposting satu kartu saat langganan menjadi aktif dan kartu lainnya saat langganan dibatalkan.

subscription_card.js

function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        type: "message",
        attachments: [{
          contentType: "application/vnd.microsoft.card.adaptive",
          content: {
            type: "AdaptiveCard",
            body: [
              {
                type: "TextBlock",
                text: "📄 Subscription Activated",
                weight: "Bolder",
                color: "Good"
              },
              {
                type: "FactSet",
                facts: [
                  { title: "Customer", value: s.customer.email },
                  { title: "Product", value: s.product_id },
                  { title: "Amount", value: `$${(s.recurring_pre_tax_amount / 100).toFixed(2)}/${s.payment_frequency_interval}` },
                  { title: "Next Billing", value: new Date(s.next_billing_date).toLocaleDateString() }
                ]
              }
            ]
          }
        }]
      };
      break;
    case "subscription.cancelled":
      webhook.payload = {
        type: "message",
        attachments: [{
          contentType: "application/vnd.microsoft.card.adaptive",
          content: {
            type: "AdaptiveCard",
            body: [
              {
                type: "TextBlock",
                text: "⚠️ Subscription Cancelled",
                weight: "Bolder",
                color: "Warning"
              },
              {
                type: "FactSet",
                facts: [
                  { title: "Customer", value: s.customer.email },
                  { title: "Product", value: s.product_id },
                  { title: "Cancelled At", value: new Date(s.cancelled_at).toLocaleDateString() }
                ]
              }
            ]
          }
        }]
      };
      break;
  }
  return webhook;
}

Peringatan Sengketa

Contoh ini memposting kartu untuk setiap event dispute.*. Judul dan warna berubah saat sengketa dimenangkan atau kalah.

dispute_card.js

function handler(webhook) {
  if (webhook.eventType.startsWith("dispute.")) {
    const d = webhook.payload.data;
    const color = d.dispute_status === "dispute_won" ? "Good" : d.dispute_status === "dispute_lost" ? "Attention" : "Warning";
    const title = d.dispute_status === "dispute_won" ? "🏆 Dispute Won" : d.dispute_status === "dispute_lost" ? "❌ Dispute Lost" : "🚨 Dispute Update";
    
    webhook.payload = {
      type: "message",
      attachments: [{
        contentType: "application/vnd.microsoft.card.adaptive",
        content: {
          type: "AdaptiveCard",
          body: [
            {
              type: "TextBlock",
              text: title,
              weight: "Bolder",
              color: color
            },
            {
              type: "FactSet",
              facts: [
                { title: "Payment ID", value: d.payment_id },
                { title: "Amount", value: `$${(d.amount / 100).toFixed(2)}` },
                { title: "Status", value: d.dispute_status },
                { title: "Stage", value: d.dispute_stage }
              ]
            }
          ]
        }
      }]
    };
  }
  return webhook;
}

Tips

Gunakan Adaptive Cards untuk format yang kaya dan interaktif.
Pilih warna berdasarkan makna: Good (hijau), Warning (kuning), dan Attention (merah).
Buat set fakta tetap singkat dan mudah dibaca.
Sebelum mengandalkan endpoint, buka tab Testing lalu klik Send example untuk memposting kartu sampel ke channel Anda.

Pemecahan Masalah

No Messages in Teams

Periksa apakah URL webhook sudah benar dan workflow telah diaktifkan.
Periksa apakah transformasi mengembalikan JSON Adaptive Card yang valid.
Periksa apakah workflow memiliki izin untuk memposting di channel.

Card Formatting Issues

Jalankan transformasi di bawah Test this code dan periksa hasilnya terhadap skema Adaptive Card.
Periksa apakah semua field yang diperlukan tersedia.
Periksa apakah nilai warna valid, seperti Default, Good, Warning, atau Attention.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Pendahuluan

Memulai

Contoh Kode Transformasi

Kartu Pembayaran Dasar

Manajemen Langganan

Peringatan Sengketa

Tips

Pemecahan Masalah

​Pendahuluan

​Memulai

​Contoh Kode Transformasi

​Kartu Pembayaran Dasar

​Manajemen Langganan

​Peringatan Sengketa

​Tips

​Pemecahan Masalah

Pendahuluan

Memulai

Contoh Kode Transformasi

Kartu Pembayaran Dasar

Manajemen Langganan

Peringatan Sengketa

Tips

Pemecahan Masalah