Microsoft Teams

Introduktion

Microsoft Teams-integrationen publicerar Dodo Payments-händelser till en Teams-kanal som Adaptive Cards, så att ditt team ser betalningar, prenumerationsändringar och tvister när de inträffar. Använd den när Teams är platsen där ditt företagsteam arbetar.

Denna guide förutsätter att du har administratörsbehörighet för att skapa webhooks i din Microsoft Teams-arbetsyta.

Komma igång

Open the Webhook Section

I Dodo Payments-instrumentpanelen går du till Developer → Webhooks och klickar på Add endpoint.

Add endpoint dialog with Teams selected in the Integration dropdown

Select Microsoft Teams

Välj Teams i listan Integration.

Create Teams Webhook

Microsoft har avvecklat Office 365-anslutningsprogrammen Incoming Webhook i Teams, så skapa webhooken med appen Workflows:

Öppna kanalen i Teams som ska ta emot aviseringar.
Klicka på ⋯ bredvid kanalnamnet och välj Workflows.
Välj mallen Post to a channel when a webhook request is received.
Bekräfta teamet och kanalen och klicka sedan på Add workflow.
Kopiera webhook-URL:en som Teams visar.

Paste Webhook URL

Klistra in Teams webhook-URL i fältet Endpoint URL.

Customize Transformation

Redigera koden under Transformation code för att formatera varje händelse som ett Adaptive Card. Utgå från exemplen nedan.

Test & Create

Kör transformeringen mot en exempelnyttolast under Test this code och klicka sedan på Create endpoint.

Done

Din Teams-kanal tar nu emot Dodo Payments-händelser som Adaptive Cards.

Exempel på transformationskod

Varje exempel ersätter händelsens nyttolast med ett Teams-meddelande som innehåller en Adaptive Card-bilaga.

Grundläggande betalkort

Det här exemplet publicerar beloppet, kundens e-postadress och betalnings-ID:t när en betalning lyckas.

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

Prenumerationshantering

Det här exemplet publicerar ett kort när en prenumeration blir aktiv och ett annat när den avslutas.

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

Tvistaviseringar

Det här exemplet publicerar ett kort för varje dispute.*-händelse. Titel och färg ändras när en tvist avgörs till din fördel eller nackdel.

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

Använd Adaptive Cards för avancerad, interaktiv formatering.
Välj färger efter betydelse: Good (grönt), Warning (gult) och Attention (rött).
Håll faktauppsättningarna korta och lättlästa.
Innan du förlitar dig på slutpunkten öppnar du fliken Testing och klickar på Send example för att publicera ett exempelkort i kanalen.

Felsökning

No Messages in Teams

Kontrollera att webhook-URL:en är korrekt och att arbetsflödet är aktiverat.
Kontrollera att transformeringen returnerar giltig JSON för Adaptive Card.
Kontrollera att arbetsflödet har behörighet att publicera i kanalen.

Card Formatting Issues

Kör transformeringen under Test this code och kontrollera resultatet mot schemat för Adaptive Card.
Kontrollera att alla obligatoriska fält finns med.
Kontrollera att färgvärdena är giltiga, till exempel Default, Good, Warning eller Attention.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduktion

Komma igång

Exempel på transformationskod

Grundläggande betalkort

Prenumerationshantering

Tvistaviseringar

Tips

Felsökning

​Introduktion

​Komma igång

​Exempel på transformationskod

​Grundläggande betalkort

​Prenumerationshantering

​Tvistaviseringar

​Tips

​Felsökning

Introduktion

Komma igång

Exempel på transformationskod

Grundläggande betalkort

Prenumerationshantering

Tvistaviseringar

Tips

Felsökning