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

# Recuperação de Carrinho Abandonado

> Detecte automaticamente fechamentos de compra incompletos ou falhos e envie sequências de e-mails direcionados para trazer os clientes de volta para completar sua compra.

<Info>
  A Recuperação de Carrinho Abandonado (ACR) detecta fechamentos de compra incompletos ou falhos e envia sequências de e-mails automatizados para trazer os clientes de volta. Combine com incentivos de desconto opcionais para maximizar as taxas de recuperação.
</Info>

## O que é a Recuperação de Carrinho Abandonado?

ACR identifica automaticamente clientes que iniciaram mas não completaram um fechamento de compra — seja porque o pagamento falhou ou porque eles saíram antes de pagar — e envia uma sequência de e-mails de recuperação para trazê-los de volta.

* **Pagamentos falhos**: Cliente tentou o pagamento, mas ele foi recusado ou deu erro
* **Fechamentos de compra incompletos**: Cliente visitou o fechamento de compra, mas nunca tentou o pagamento

## Como ACR Funciona

<Steps>
  <Step title="Detection">
    Monitoramos pagamentos com mais de 60 minutos que não foram bem-sucedidos. Isso inclui pagamentos falhos e fechamentos de compra onde o cliente nunca tentou o pagamento.
  </Step>

  <Step title="Classification">
    Cada fechamento de compra abandonado é classificado por motivo:

    * **Pagamento Falhou**: O cliente tentou o pagamento, mas falhou
    * **Fechamento de Compra Incompleto**: O cliente visitou o fechamento de compra, mas nunca tentou o pagamento
  </Step>

  <Step title="Email Sequence">
    Com base na classificação, o sistema envia até 3 e-mails de recuperação em intervalos configurados. Cada e-mail contém um link de recuperação único.
  </Step>

  <Step title="Recovery">
    Quando o cliente clica no link de recuperação, ele é levado para uma página de recuperação exibindo seu carrinho original. Ele pode completar o pagamento com uma nova sessão de fechamento de compra.
  </Step>
</Steps>

## Ciclo de Vida de Status

Cada fechamento de compra abandonado passa pelos seguintes estados:

| Status       | Descrição                                                                                          |
| ------------ | -------------------------------------------------------------------------------------------------- |
| `abandoned`  | Fechamento de compra detectado como abandonado, sem e-mails enviados ainda                         |
| `recovering` | Pelo menos um e-mail de recuperação foi enviado                                                    |
| `recovered`  | Cliente completou o pagamento via o link de recuperação                                            |
| `exhausted`  | Todos os e-mails enviados sem recuperação, ou um fechamento de compra mais recente substituiu este |
| `opted_out`  | Cliente se descadastrou dos e-mails de recuperação                                                 |

## Configurando ACR

Habilite e configure ACR nas **Configurações** do seu painel de controle.

<Frame caption="Abandoned Cart Recovery settings in the dashboard">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/acr-settings.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=564184c25e7ec3e98f1ec07264ebba5d" alt="Página de configurações do ACR mostrando alternância de habilitação, configuração de desconto e editor de sequência de e-mails" style={{ maxHeight: '500px', width: 'auto' }} width="2838" height="1386" data-path="images/recovery/acr-settings.png" />
</Frame>

### Configurações Globais

| Configuração                     | Descrição                                                                           | Padrão    |
| -------------------------------- | ----------------------------------------------------------------------------------- | --------- |
| **Habilitado**                   | Alternância principal para ACR                                                      | Desligado |
| **Desconto Habilitado**          | Gerar automaticamente um código de desconto para e-mails de recuperação             | Desligado |
| **Porcentagem de Desconto**      | Porcentagem de desconto que será aplicada ao fechamento de compra para este cliente | 0         |
| **Dias de Validade do Desconto** | Quantos dias o código de desconto gerado automaticamente permanece válido           | 5         |

### Sequências de E-mails

ACR suporta duas sequências de e-mails — **Pagamento Falhou** e **Fechamento de Compra Incompleto** — cada uma com até 3 e-mails configuráveis.

<Frame caption="ACR email sequence configuration">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/acr-email-config.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=3f2bd0fbdf6b2b6bfe898c17bf2693a4" alt="Editor de sequência de e-mails mostrando assunto, corpo, tempo e alternância de habilitação para cada e-mail na sequência" style={{ maxHeight: '500px', width: 'auto' }} width="1138" height="1670" data-path="images/recovery/acr-email-config.png" />
</Frame>

| Configuração       | Descrição                                                           |
| ------------------ | ------------------------------------------------------------------- |
| **Habilitado**     | Alternar e-mails individuais ativados ou desativados sem excluí-los |
| **Atraso**         | Quanto tempo após a detecção de abandono para enviar este e-mail    |
| **Assunto**        | Linha de assunto do e-mail com espaços reservados de variável       |
| **Corpo**          | Corpo de e-mail HTML com espaços reservados de variável             |
| **Responder para** | Endereço de e-mail para respostas dos clientes                      |

**Tempo padrão dos e-mails:**

| E-mail # | Atraso Padrão |
| -------- | ------------- |
| 1        | 1 hora        |
| 2        | 24 horas      |
| 3        | 72 horas      |

### Exemplos de E-mails de Recuperação

ACR envia diferentes e-mails dependendo do motivo do abandono. Abaixo estão exemplos de cada tipo visto pelo cliente.

<Tabs>
  <Tab title="Payment Failed">
    <Frame caption="Recovery email sent when a payment attempt fails">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/acr-failed-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=a8da91be6212c9fdd2b373572e3c1912" alt="E-mail de recuperação para um pagamento falhou mostrando nome da loja, mensagem sobre falha de pagamento, resumo do pedido com detalhes do produto, desconto e um botão Retomar Fechamento" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/acr-failed-email.png" />
    </Frame>
  </Tab>

  <Tab title="Checkout Incomplete">
    <Frame caption="Recovery email sent when a customer leaves without attempting payment">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/acr-abandoned-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=05adcd350e1ceefa7854c86a37c862b9" alt="E-mail de recuperação para um fechamento de compra incompleto mostrando nome da loja, mensagem sobre carrinho salvo, resumo do pedido com detalhes do produto, desconto e um botão Retomar Fechamento" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/acr-abandoned-email.png" />
    </Frame>
  </Tab>
</Tabs>

## Descontos de Recuperação

Quando o desconto está habilitado, o ACR gera automaticamente um código de desconto único e de uso único para cada fechamento de compra abandonado. O desconto:

* É restrito ao(s) produto(s) do fechamento de compra original
* Tem um período de expiração configurável
* É limitado a uma redenção
* É oculto da lista de descontos do seu painel (uso interno apenas)

<Tip>
  Comece com um desconto modesto (5-10%) para testar o impacto na conversão antes de aumentar. Mesmo um pequeno incentivo pode melhorar significativamente as taxas de recuperação.
</Tip>

## Experiência de Recuperação do Cliente

Quando um cliente clica no link de recuperação em um e-mail, ele é levado de volta para
sua sessão de fechamento de compra original. A página exibe o produto que ele deixou
para trás, junto com um código de desconto se um tiver sido configurado.

## Análise

Acompanhe o desempenho do ACR na seção **Análises** do seu painel de controle.

<Frame caption="Recovery analytics dashboard showing ACR and dunning metrics">
  <img src="https://mintcdn.com/dodopayments/B3-0kuKcZDP1TiJD/images/recovery/recovery-analytics.png?fit=max&auto=format&n=B3-0kuKcZDP1TiJD&q=85&s=d3bf0c7474818bc4584b75654423e14c" alt="Painel de análise de recuperação mostrando contagens de fechamento de compra abandonado, taxas de recuperação, receita recuperada, tempo médio para recuperar, e desagregações por produto e e-mail" style={{ maxHeight: '500px', width: 'auto' }} width="2548" height="2190" data-path="images/recovery/recovery-analytics.png" />
</Frame>

| Métrica                               | Descrição                                                              |
| ------------------------------------- | ---------------------------------------------------------------------- |
| **Fechamentos de Compra Abandonados** | Número total de fechamentos de compra abandonados detectados           |
| **Taxa de Recuperação**               | Porcentagem de fechamentos de compra abandonados que foram recuperados |
| **Receita Recuperada**                | Receita total recuperada através do ACR                                |
| **Tempo Médio de Recuperação**        | Tempo médio do abandono à recuperação                                  |
| **Recuperação por E-mail**            | Desagregação de qual e-mail na sequência levou à recuperação           |
| **Recuperação por Produto**           | Quais produtos têm as maiores taxas de recuperação                     |

## Eventos de Webhook

| Evento                         | Descrição                                                                |
| ------------------------------ | ------------------------------------------------------------------------ |
| `abandoned_checkout.detected`  | Um fechamento de compra abandonado foi detectado e a recuperação começou |
| `abandoned_checkout.recovered` | Um cliente completou o pagamento através do fluxo de recuperação         |

<Card title="Recovery Webhook Payloads" icon="code" href="/developer-resources/webhooks/intents/recovery">
  Veja os esquemas completos de payload de webhook para eventos de ACR.
</Card>

## Casos Especiais

| Cenário                                           | Comportamento                                                                                               |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Cliente completa a compra antes do próximo e-mail | A recuperação é detectada no momento do envio; o fechamento de compra é marcado como recuperado se elegível |
| Cliente inicia um novo fechamento de compra       | Antigo fechamento de compra abandonado é marcado como `exhausted`                                           |
| Cliente clica em "Pagar" após já ter recuperado   | Página de recuperação mostra uma confirmação de que o pagamento já foi completado                           |
| Cliente se descadastra                            | Fechamento de Compra Abandonado é marcado como `opted_out`; nenhum e-mail adicional é enviado               |

## Melhores Práticas

* **Comece com os padrões**: O tempo e os assuntos dos e-mails padrão são otimizados para padrões comuns de recuperação. Personalize após ter dados de base.
* **Personalize os e-mails**: Use variáveis de template para tornar os e-mails pessoais e relevantes para o cliente.
* **Monitore as análises**: Acompanhe as taxas de recuperação por e-mail para identificar quais mensagens geram mais conversões. Desative os e-mails com baixo desempenho.
* **Use descontos estrategicamente**: Comece pequeno (5-10%) para proteger as margens enquanto testa o impacto na conversão.
* **Mantenha os e-mails concisos**: E-mails de recuperação devem ser curtos e orientados para a ação. Um chamado claro para ação gera melhores resultados do que explicações longas.

<Info>
  O ACR é projetado para funcionar automaticamente uma vez habilitado. Comece com as configurações padrão, monitore suas análises e itere com base nos dados de desempenho.
</Info>

## Relacionados

<CardGroup cols={2}>
  <Card title="Recovery Webhooks" icon="webhook" href="/developer-resources/webhooks/intents/recovery">
    Reaja a eventos `abandoned_checkout.detected` e `abandoned_checkout.recovered`.
  </Card>

  <Card title="Subscription Dunning" icon="rotate" href="/features/recovery/subscription-dunning">
    Recupere assinaturas expiradas com e-mails de cobrança automática.
  </Card>

  <Card title="Customer Portal" icon="id-card" href="/features/customer-portal">
    Clientes completam ações de recuperação através do portal do cliente.
  </Card>

  <Card title="Discounts" icon="percent" href="/features/discount-codes">
    O ACR pode gerar automaticamente códigos de desconto para incentivar a recuperação.
  </Card>
</CardGroup>
