Microsoft Teams

Introdução

A integração com o Microsoft Teams publica eventos do Dodo Payments em um canal do Teams como Adaptive Cards, para que sua equipe veja pagamentos, alterações em assinaturas e disputas à medida que acontecem. Use-a quando o Teams for o local de trabalho da sua equipe de negócios.

Este guia pressupõe que você tem acesso de administrador para criar webhooks no seu workspace do Microsoft Teams.

Começando

Open the Webhook Section

No dashboard do Dodo Payments, acesse Developer → Webhooks e clique em Adicionar endpoint.

Caixa de diálogo Adicionar endpoint com Teams selecionado no menu suspenso de integração

Select Microsoft Teams

Na lista Integration, selecione Teams.

Create Teams Webhook

A Microsoft aposentou os conectores Incoming Webhook do Office 365 no Teams, então crie o webhook com o app Workflows:

No Teams, abra o canal que deve receber as notificações.
Clique em ⋯ ao lado do nome do canal e escolha Workflows.
Selecione o template Post to a channel when a webhook request is received.
Confirme a equipe e o canal e clique em Add workflow.
Copie a URL do webhook exibida pelo Teams.

Paste Webhook URL

Cole a URL do webhook do Teams no campo Endpoint URL.

Customize Transformation

Edite o código em Transformation code para formatar cada evento como um Adaptive Card. Comece pelos exemplos abaixo.

Test & Create

Em Test this code, execute a transformação usando um payload de exemplo e clique em Create endpoint.

Done

Seu canal do Teams agora recebe eventos do Dodo Payments como Adaptive Cards.

Exemplos de código de transformação

Cada exemplo substitui o payload do evento por uma mensagem do Teams que contém um anexo com um Adaptive Card.

Card básico de pagamento

Este exemplo publica o valor, o e-mail do cliente e o ID do pagamento quando um pagamento é concluído com sucesso.

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

Gerenciamento de assinaturas

Este exemplo publica um card quando uma assinatura é ativada e outro quando é cancelada.

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 exemplo publica um card para cada evento dispute.*. O título e a cor mudam quando uma disputa é ganha ou perdida.

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

Dicas

Use Adaptive Cards para uma formatação rica e interativa.
Escolha as cores de acordo com o significado: Good (verde), Warning (amarelo) e Attention (vermelho).
Mantenha os conjuntos de informações curtos e fáceis de ler.
Antes de depender do endpoint, abra a aba Testing e clique em Send example para publicar um card de exemplo no seu canal.

Solução de problemas

No Messages in Teams

Verifique se a URL do webhook está correta e se o workflow está ativado.
Verifique se a transformação retorna um JSON de Adaptive Card válido.
Verifique se o workflow tem permissão para publicar no canal.

Card Formatting Issues

Execute a transformação em Test this code e confira o resultado em relação ao schema do Adaptive Card.
Verifique se todos os campos obrigatórios estão presentes.
Verifique se os valores de cor são válidos, como Default, Good, Warning ou Attention.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introdução

Começando

Exemplos de código de transformação

Card básico de pagamento

Gerenciamento de assinaturas

Alertas de disputas

Dicas

Solução de problemas

​Introdução

​Começando

​Exemplos de código de transformação

​Card básico de pagamento

​Gerenciamento de assinaturas

​Alertas de disputas

​Dicas

​Solução de problemas

Introdução

Começando

Exemplos de código de transformação

Card básico de pagamento

Gerenciamento de assinaturas

Alertas de disputas

Dicas

Solução de problemas