Pular para o conteúdo principal

​
Introdução

A integração do AutoSend com o Dodo Payments permite que você envie automaticamente notificações por e-mail em tempo real para todos os eventos de pagamento, desde transações bem-sucedidas até tentativas falhadas e confirmações de reembolso. Envie e-mails transacionais para eventos de pagamento usando a poderosa API de e-mail do AutoSend.
Esta integração requer sua chave de API AutoSend para autenticação. Você pode encontrar sua chave de API no painel do AutoSend em Settings > API Keys.

​
Começando

Siga estas etapas para integrar o AutoSend com o Dodo Payments:
1

Open Webhook Section

Navegue até a seção Webhooks no painel da Dodo Payments.
Adicionar endpoint e menu suspenso de integrações
2

Select AutoSend Integration

Escolha AutoSend na lista de integrações disponíveis.
3

Enter API Key

Forneça sua chave de API AutoSend para autenticação. Você pode encontrá-la no painel do AutoSend em Settings > API Keys.

Learn how to create and manage API keys

Consulte a documentação do AutoSend para obter instruções detalhadas sobre como criar e gerenciar chaves de API.
4

Configure Transformation

Configure manipuladores de transformação em JavaScript para personalizar o conteúdo dos e-mails com base nos eventos de pagamento.
5

Test & Create

Teste sua configuração de webhook para garantir que os e-mails sejam enviados corretamente e, em seguida, crie a integração.
6

Activation Complete

🎉 Sua integração com o AutoSend já está ativa e enviará e-mails automaticamente para os eventos de pagamento configurados.

​
Exemplos de Código

​
E-mail de Confirmação de Pagamento

Envie um e-mail de confirmação quando um pagamento for processado com sucesso:
payment_confirmation.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "payments@mail.yourdomain.com",
        name: "Your Company",
      },
      subject: "Payment Successful - Thank you for your purchase!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.amount,
        currency: p.currency,
        paymentId: p.payment_id,
        paymentDate: new Date(p.created_at).toLocaleDateString(),
      },
      replyTo: {
        email: "support@yourdomain.com",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

​
E-mail de Boas-Vindas de Assinatura

Envie um e-mail de boas-vindas quando uma nova assinatura for criada:
subscription_welcome.js
function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: s.customer.email,
        name: s.customer.name,
      },
      from: {
        email: "subscriptions@mail.yourdomain.com",
        name: "Your Company",
      },
      subject: "Welcome to your subscription!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: s.customer.name,
        planName: s.plan.name,
        billingInterval: s.billing_interval,
        nextBillingDate: new Date(s.next_billing_at).toLocaleDateString(),
        subscriptionId: s.subscription_id,
      },
      replyTo: {
        email: "support@yourdomain.com",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

​
Notificação de Falha de Pagamento

Envie um e-mail de notificação quando um pagamento falhar:
payment_failure.js
function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "billing@mail.yourdomain.com",
        name: "Your Company Billing",
      },
      subject: "Payment Failed - Action Required",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.amount,
        currency: p.currency,
        failureReason: p.failure_reason,
        paymentId: p.payment_id,
        retryUrl: `https://yourdomain.com/billing/retry/${p.payment_id}`,
      },
      replyTo: {
        email: "billing@yourdomain.com",
        name: "Billing Support",
      },
    };
  }
  return webhook;
}

​
Melhores Práticas

  • Verifique seu domínio de remetente: Certifique-se de que seu domínio de e-mail de remetente esteja verificado no AutoSend para melhorar a entregabilidade e evitar problemas de autenticação. Domínios verificados ajudam a evitar que os e-mails caiam em pastas de spam.
  • Use dados dinâmicos para personalização: Utilize o campo dynamicData para personalizar os e-mails com informações específicas do cliente, como nomes, valores de pagamento e detalhes de assinatura. E-mails personalizados possuem taxas de engajamento mais altas.
  • Escreva linhas de assunto claras: Escreva linhas de assunto descritivas que indiquem claramente o propósito do e-mail. Evite palavras que acionem spam e mantenha os assuntos concisos (menos de 50 caracteres).
  • Teste antes da produção: Sempre teste seus e-mails antes de enviá-los em produção. Isso garante que o conteúdo do seu e-mail seja renderizado corretamente e que todos os dados dinâmicos estejam mapeados corretamente.

​
Referência da API

Para detalhes completos sobre a API do AutoSend, incluindo todos os parâmetros disponíveis e códigos de erro, visite a Documentação da API do AutoSend.

​
Solução de Problemas

  • Verifique se a chave de API está correta e ativa
  • Confira se o domínio remetente está verificado no AutoSend
  • Garanta que os endereços de e-mail dos destinatários sejam válidos
  • Revise os limites e cotas de envio do AutoSend
  • Verifique se a URL do endpoint da API está correta: https://api.autosend.com/v1/mails/send
  • Confira se os parâmetros obrigatórios estão presentes no payload
  • Valide se a estrutura JSON corresponde ao formato da API AutoSend
  • Verifique se todos os campos obrigatórios estão presentes (to, from, templateId ou html/text)
  • Assegure-se de que os endereços de e-mail estejam corretamente formatados
  • Confirme se templateId é válido ao usar modelos
  • Verifique se as chaves dynamicData correspondem às variáveis do seu modelo
  • Verifique se o ID do modelo está correto e ativo no AutoSend
  • Garanta que as chaves dynamicData correspondam às variáveis usadas no seu modelo
  • Confira se todas as variáveis obrigatórias do modelo foram fornecidas
  • Teste seu modelo de forma independente no painel do AutoSend