> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AutoSend

> Aprenda a usar a API de e-mail do AutoSend para enviar e-mails transacionais automatizados para suas transações, reembolsos e eventos de pagamento do Dodo Payments.

## 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.

<Info>
  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.
</Info>

## Começando

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

<Steps>
  <Step title="Open Webhook Section">
    Navegue para a seção de Webhooks no seu painel do Dodo Payments.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/VOF9xBBvs1EjN4xq/images/integrations/autosend.png?fit=max&auto=format&n=VOF9xBBvs1EjN4xq&q=85&s=8645c6b295d3fecdf62f046e4480b1e4" alt="Adicionar Endpoint e dropdown de integrações" style={{ maxHeight: '500px', width: 'auto' }} width="1750" height="1234" data-path="images/integrations/autosend.png" />
    </Frame>
  </Step>

  <Step title="Select AutoSend Integration">
    Escolha AutoSend na lista de integrações disponíveis.
  </Step>

  <Step title="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.

    <Card title="Learn how to create and manage API keys" icon="key" href="https://docs.autosend.com/api-keys">
      Consulte a documentação do AutoSend para obter instruções detalhadas sobre como criar e gerenciar chaves de API.
    </Card>
  </Step>

  <Step title="Configure Transformation">
    Configure manipuladores de transformação em JavaScript para personalizar o conteúdo dos e-mails com base nos eventos de pagamento.
  </Step>

  <Step title="Test & Create">
    Teste sua configuração de webhook para garantir que os e-mails sejam enviados corretamente e, em seguida, crie a integração.
  </Step>

  <Step title="Activation Complete">
    🎉 Sua integração com o AutoSend já está ativa e enviará e-mails automaticamente para os eventos de pagamento configurados.
  </Step>
</Steps>

## 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:

```javascript payment_confirmation.js icon="js" expandable theme={null}
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:

```javascript subscription_welcome.js icon="js" expandable theme={null}
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:

```javascript payment_failure.js icon="js" expandable theme={null}
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](https://docs.autosend.com/api-reference/mails/send).

## Solução de Problemas

<AccordionGroup>
  <Accordion title="Emails not being sent">
    * 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
  </Accordion>

  <Accordion title="Transformation errors">
    * 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
  </Accordion>

  <Accordion title="Template issues">
    * 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
  </Accordion>
</AccordionGroup>