Microsoft Teams

Introduction

L’intégration Microsoft Teams publie les événements de Dodo Payments dans un canal Teams sous forme d’Adaptive Cards, afin que votre équipe voie les paiements, les changements d’abonnement et les litiges au moment où ils se produisent. Utilisez-la si Teams est l’espace de travail de votre équipe métier.

Ce guide suppose que vous disposez des droits d’administrateur pour créer des webhooks dans votre espace de travail Microsoft Teams.

Commencer

Open the Webhook Section

Dans le tableau de bord Dodo Payments, accédez à Développeur → Webhooks et cliquez sur Ajouter un endpoint.

Add endpoint dialog with Teams selected in the Integration dropdown

Select Microsoft Teams

Dans la liste Intégration, sélectionnez Teams.

Create Teams Webhook

Microsoft a retiré les connecteurs Incoming Webhook d’Office 365 dans Teams. Créez donc le webhook avec l’application Workflows :

Dans Teams, ouvrez le canal qui doit recevoir les notifications.
Cliquez sur ⋯ à côté du nom du canal, puis choisissez Workflows.
Sélectionnez le modèle Post to a channel when a webhook request is received.
Confirmez l’équipe et le canal, puis cliquez sur Add workflow.
Copiez l’URL du webhook affichée par Teams.

Paste Webhook URL

Collez l’URL du webhook Teams dans le champ URL de l’endpoint.

Customize Transformation

Modifiez le code sous Code de transformation afin de formater chaque événement sous forme d’Adaptive Card. Commencez avec les exemples ci-dessous.

Test & Create

Sous Tester ce code, exécutez la transformation avec un exemple de payload, puis cliquez sur Créer l’endpoint.

Done

Votre canal Teams reçoit désormais les événements de Dodo Payments sous forme d’Adaptive Cards.

Exemples de code de transformation

Chaque exemple remplace le payload de l’événement par un message Teams contenant une pièce jointe Adaptive Card.

Carte de paiement de base

Cet exemple publie le montant, l’adresse e-mail du client et l’identifiant du paiement lorsqu’un paiement aboutit.

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

Gestion des abonnements

Cet exemple publie une carte lorsqu’un abonnement devient actif, puis une autre lorsqu’il est annulé.

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

Alertes de litige

Cet exemple publie une carte pour chaque événement dispute.*. Le titre et la couleur changent lorsqu’un litige est gagné ou perdu.

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

Conseils

Utilisez les Adaptive Cards pour un formatage riche et interactif.
Choisissez les couleurs en fonction de leur signification : Good (vert), Warning (jaune) et Attention (rouge).
Gardez les ensembles de faits courts et lisibles.
Avant de vous fier à l’endpoint, ouvrez son onglet Tests et cliquez sur Envoyer un exemple pour publier une carte d’exemple dans votre canal.

Résolution des problèmes

No Messages in Teams

Vérifiez que l’URL du webhook est correcte et que le workflow est activé.
Vérifiez que la transformation renvoie un JSON Adaptive Card valide.
Vérifiez que le workflow dispose des autorisations nécessaires pour publier dans le canal.

Card Formatting Issues

Exécutez la transformation sous Tester ce code et vérifiez le résultat par rapport au schéma Adaptive Card.
Vérifiez que tous les champs requis sont présents.
Vérifiez que les valeurs de couleur sont valides, notamment Default, Good, Warning ou Attention.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduction

Commencer

Exemples de code de transformation

Carte de paiement de base

Gestion des abonnements

Alertes de litige

Conseils

Résolution des problèmes

​Introduction

​Commencer

​Exemples de code de transformation

​Carte de paiement de base

​Gestion des abonnements

​Alertes de litige

​Conseils

​Résolution des problèmes

Introduction

Commencer

Exemples de code de transformation

Carte de paiement de base

Gestion des abonnements

Alertes de litige

Conseils

Résolution des problèmes