Microsoft Teams

Introducción

La integración con Microsoft Teams publica eventos de Dodo Payments en un canal de Teams como Adaptive Cards, para que tu equipo vea pagos, cambios en suscripciones y disputas en el momento en que ocurren. Úsala cuando Teams sea el espacio de trabajo de tu equipo empresarial.

Esta guía asume que tienes acceso de administrador para crear webhooks en tu espacio de trabajo de Microsoft Teams.

Comenzando

Open the Webhook Section

En el dashboard de Dodo Payments, ve a Desarrollador → Webhooks y haz clic en Añadir endpoint.

Add endpoint dialog with Teams selected in the Integration dropdown

Select Microsoft Teams

En la lista de Integration, selecciona Teams.

Create Teams Webhook

Microsoft retiró los conectores Incoming Webhook de Office 365 en Teams, así que crea el webhook con la aplicación Workflows:

En Teams, abre el canal que debe recibir las notificaciones.
Haz clic en ⋯ junto al nombre del canal y selecciona Workflows.
Elige la plantilla Post to a channel when a webhook request is received.
Confirma el equipo y el canal, y haz clic en Add workflow.
Copia la URL del webhook que muestra Teams.

Paste Webhook URL

Pega la URL del webhook de Teams en el campo Endpoint URL.

Customize Transformation

Edita el código en Transformation code para dar formato a cada evento como una Adaptive Card. Comienza con los ejemplos siguientes.

Test & Create

En Test this code, ejecuta la transformación con un payload de ejemplo y, a continuación, haz clic en Create endpoint.

Done

Tu canal de Teams ahora recibe eventos de Dodo Payments como Adaptive Cards.

Ejemplos de código de transformación

Cada ejemplo reemplaza el payload del evento por un mensaje de Teams que contiene un archivo adjunto con una Adaptive Card.

Tarjeta de pago básica

Este ejemplo publica el importe, el correo electrónico del cliente y el ID de pago cuando un pago se completa correctamente.

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

Gestión de suscripciones

Este ejemplo publica una tarjeta cuando una suscripción se activa y otra cuando se cancela.

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

Alertas de disputas

Este ejemplo publica una tarjeta para cada evento dispute.*. El título y el color cambian cuando una disputa se gana o se pierde.

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

Consejos

Usa Adaptive Cards para obtener un formato enriquecido e interactivo.
Elige los colores según su significado: Good (verde), Warning (amarillo) y Attention (rojo).
Mantén los conjuntos de datos breves y fáciles de leer.
Antes de depender del endpoint, abre su pestaña Testing y haz clic en Send example para publicar una tarjeta de ejemplo en tu canal.

Solución de problemas

No Messages in Teams

Comprueba que la URL del webhook sea correcta y que el flujo de trabajo esté activado.
Comprueba que la transformación devuelva un JSON de Adaptive Card válido.
Comprueba que el flujo de trabajo tenga permiso para publicar en el canal.

Card Formatting Issues

Ejecuta la transformación en Test this code y comprueba el resultado con el esquema de Adaptive Card.
Comprueba que todos los campos obligatorios estén presentes.
Comprueba que los valores de color sean válidos, como Default, Good, Warning o Attention.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introducción

Comenzando

Ejemplos de código de transformación

Tarjeta de pago básica

Gestión de suscripciones

Alertas de disputas

Consejos

Solución de problemas

​Introducción

​Comenzando

​Ejemplos de código de transformación

​Tarjeta de pago básica

​Gestión de suscripciones

​Alertas de disputas

​Consejos

​Solución de problemas

Introducción

Comenzando

Ejemplos de código de transformación

Tarjeta de pago básica

Gestión de suscripciones

Alertas de disputas

Consejos

Solución de problemas