Microsoft Teams

Introduzione

L’integrazione con Microsoft Teams pubblica gli eventi di Dodo Payments in un canale Teams come Adaptive Cards, così il tuo team può vedere pagamenti, modifiche agli abbonamenti e contestazioni mentre si verificano. Usala quando Teams è l’ambiente di lavoro del tuo team aziendale.

Questa guida presuppone che tu abbia accesso amministrativo per creare webhook nel tuo workspace Microsoft Teams.

Iniziare

Open the Webhook Section

Nel dashboard di Dodo Payments, vai su Sviluppatore → Webhooks e fai clic su Aggiungi endpoint.

Finestra di dialogo per aggiungere un endpoint con Teams selezionato nel menu a discesa Integrazione

Select Microsoft Teams

Nell’elenco Integration, seleziona Teams.

Create Teams Webhook

Microsoft ha ritirato i connettori Incoming Webhook di Office 365 in Teams, quindi crea il webhook con l’app Workflows:

In Teams, apri il canale che deve ricevere le notifiche.
Fai clic su ⋯ accanto al nome del canale e scegli Workflows.
Seleziona il modello Post to a channel when a webhook request is received.
Conferma il team e il canale, quindi fai clic su Add workflow.
Copia l’URL del webhook mostrato da Teams.

Paste Webhook URL

Incolla l’URL del webhook Teams nel campo Endpoint URL.

Customize Transformation

Modifica il codice in Transformation code per formattare ogni evento come Adaptive Card. Inizia dagli esempi riportati di seguito.

Test & Create

In Test this code, esegui la trasformazione su un payload di esempio, quindi fai clic su Create endpoint.

Done

Il tuo canale Teams ora riceve gli eventi di Dodo Payments come Adaptive Cards.

Esempi di codice di trasformazione

Ogni esempio sostituisce il payload dell’evento con un messaggio Teams che contiene un allegato Adaptive Card.

Scheda di pagamento di base

Questo esempio pubblica l’importo, l’email del cliente e l’ID del pagamento quando un pagamento va a buon fine.

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

Gestione degli abbonamenti

Questo esempio pubblica una scheda quando un abbonamento diventa attivo e un’altra quando viene annullato.

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

Avvisi sulle contestazioni

Questo esempio pubblica una scheda per ogni evento dispute.*. Il titolo e il colore cambiano quando una contestazione viene vinta o persa.

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

Suggerimenti

Usa le Adaptive Cards per una formattazione avanzata e interattiva.
Scegli i colori in base al significato: Good (verde), Warning (giallo) e Attention (rosso).
Mantieni brevi e leggibili gli insiemi di dati.
Prima di affidarti all’endpoint, apri la scheda Testing e fai clic su Send example per pubblicare una scheda di esempio nel tuo canale.

Risoluzione dei problemi

No Messages in Teams

Verifica che l’URL del webhook sia corretto e che il workflow sia attivo.
Verifica che la trasformazione restituisca JSON valido per una Adaptive Card.
Verifica che il workflow disponga dell’autorizzazione per pubblicare nel canale.

Card Formatting Issues

Esegui la trasformazione in Test this code e verifica il risultato rispetto allo schema Adaptive Card.
Verifica che siano presenti tutti i campi obbligatori.
Verifica che i valori dei colori siano validi, ad esempio Default, Good, Warning o Attention.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduzione

Iniziare

Esempi di codice di trasformazione

Scheda di pagamento di base

Gestione degli abbonamenti

Avvisi sulle contestazioni

Suggerimenti

Risoluzione dei problemi

​Introduzione

​Iniziare

​Esempi di codice di trasformazione

​Scheda di pagamento di base

​Gestione degli abbonamenti

​Avvisi sulle contestazioni

​Suggerimenti

​Risoluzione dei problemi

Introduzione

Iniziare

Esempi di codice di trasformazione

Scheda di pagamento di base

Gestione degli abbonamenti

Avvisi sulle contestazioni

Suggerimenti

Risoluzione dei problemi