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

# Gestão de Inscrições

> Envie automaticamente sequências de e-mails para recuperar inscrições expiradas ou canceladas, solicitando aos clientes que atualizem seu método de pagamento.

<Info>
  Gestão de Inscrições envia automaticamente sequências de e-mails para clientes cujas inscrições expiraram devido a falhas de pagamento ou cancelamento pelo cliente, solicitando que atualizem o método de pagamento e reativem.
</Info>

## O que é Gestão de Inscrições?

A gestão detecta automaticamente quando uma inscrição entra em um estado recuperável e envia uma sequência de e-mails solicitando ao cliente que tome uma ação:

* **Inscrições em Espera**: Pagamento de renovação falhou (fundos insuficientes, cartão expirado, etc.)
* **Inscrições Canceladas**: Cliente cancelou no portal do cliente

## Como Funciona a Gestão de Inscrições

<Steps>
  <Step title="Trigger">
    A gestão é acionada quando uma inscrição entra em um dos dois estados:

    * **Em Espera**: Um pagamento de renovação falhou (fundos insuficientes, cartão expirado, etc.)
    * **Cancelada**: O cliente cancelou sua inscrição no portal do cliente
  </Step>

  <Step title="Email Sequence">
    Com base no estado de acionamento, o sistema envia até 4 e-mails de cobrança em intervalos configurados. Cada e-mail inclui um link para o portal do cliente, onde o cliente pode atualizar seu método de pagamento ou recomprar a inscrição.
  </Step>

  <Step title="Recovery">
    Quando o cliente atualiza seu método de pagamento através do portal do cliente, uma cobrança é criada automaticamente para as dívidas restantes. Se o pagamento for bem-sucedido, a inscrição é reativada e a tentativa de cobrança é marcada como recuperada.
  </Step>
</Steps>

## Ciclo de Vida do Status

| Status       | Descrição                                                                              |
| ------------ | -------------------------------------------------------------------------------------- |
| `recovering` | Tentativa de cobrança está ativa; e-mails estão sendo enviados                         |
| `recovered`  | Cliente atualizou o método de pagamento e o pagamento foi bem-sucedido                 |
| `exhausted`  | Todos os e-mails enviados sem recuperação ou estado da inscrição mudou inesperadamente |

<Info>
  Quando uma tentativa de cobrança é marcada como `exhausted`, o estado da inscrição não é modificado. A inscrição permanece em seu estado atual (em espera ou cancelada).
</Info>

## Configurando Gestão de Inscrições

Ative e configure a gestão a partir de **Configurações** no seu painel.

<Frame caption="Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-settings.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=7389a9413d6008800e7ca8a5c4cd1ee5" alt="Página de configurações de gestão com ativação de alternância, quatro e-mails em espera nos intervalos de 1, 3, 5 e 7 dias, e quatro e-mails cancelados nos mesmos intervalos" style={{ maxHeight: '500px', width: 'auto' }} width="2250" height="1628" data-path="images/recovery/dunning-settings.png" />
</Frame>

### Sequências de E-mail

A gestão suporta duas sequências de e-mails — **Em Espera** e **Cancelada** — cada uma com até 4 e-mails configuráveis.

Cada e-mail tem os seguintes campos configuráveis:

| Configuração       | Descrição                                                      |
| ------------------ | -------------------------------------------------------------- |
| **Ativado**        | Ative ou desative e-mails individuais sem excluí-los           |
| **Atraso**         | Quanto tempo após o evento de acionamento enviar este e-mail   |
| **Assunto**        | Linha de assunto do e-mail com marcadores de posição variáveis |
| **Corpo**          | Corpo do e-mail em HTML com marcadores de posição variáveis    |
| **Responder Para** | Endereço de e-mail para respostas dos clientes                 |

**Tempo padrão de e-mail:**

| Sequência | E-mail # | Atraso Padrão |
| --------- | -------- | ------------- |
| Em Espera | 1        | 1 dia         |
| Em Espera | 2        | 3 dias        |
| Em Espera | 3        | 5 dias        |
| Em Espera | 4        | 7 dias        |
| Cancelada | 1        | 1 dia         |
| Cancelada | 2        | 3 dias        |
| Cancelada | 3        | 5 dias        |
| Cancelada | 4        | 7 dias        |

### Exemplos de E-mails de Gestão

A gestão envia diferentes e-mails dependendo do estado da inscrição. Abaixo estão exemplos de cada tipo conforme visto pelo cliente.

<Tabs>
  <Tab title="On Hold">
    <Frame caption="Dunning email sent when a renewal payment fails and the subscription is on hold">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-on-hold-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=5e46040ed49a4da84569afdeeb87c813" alt="E-mail de gestão para uma inscrição em espera mostrando o nome da loja, mensagem sobre pagamento falhado, detalhes da inscrição com plano e valor, e um botão de Atualizar Método de Pagamento" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-on-hold-email.png" />
    </Frame>
  </Tab>

  <Tab title="Cancelled">
    <Frame caption="Dunning email sent when a customer cancels their subscription">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-cancelled-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f404fbf9415df4e4bd01562a90bd2456" alt="E-mail de gestão para uma inscrição cancelada mostrando o nome da loja, mensagem sobre o cancelamento, detalhes da inscrição com plano e valor, e um botão de Recomprar Inscrição" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-cancelled-email.png" />
    </Frame>
  </Tab>
</Tabs>

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

Quando um cliente clica no link em um e-mail de gestão, ele é levado ao portal do cliente, onde pode ver o status de sua inscrição e atualizar seu método de pagamento.

<Frame caption="Customer portal showing an on-hold subscription with option to update payment method">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/customer-recovery-page.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f498d3654afd3d70447b7b8ce7bf3767" alt="Portal do cliente mostrando uma inscrição em espera para o Plano Pro a $95.00/ano com um botão de Atualizar método de pagamento e um banner de aviso sobre o pagamento falhado" style={{ maxHeight: '500px', width: 'auto' }} width="2144" height="734" data-path="images/recovery/customer-recovery-page.png" />
</Frame>

Após o cliente atualizar seu método de pagamento, uma cobrança é criada automaticamente para quaisquer dívidas pendentes. Se o pagamento for bem-sucedido, a inscrição é reativada imediatamente.

Para uma inscrição cancelada, o cliente é levado a uma página de checkout que já tem a inscrição adicionada como produto.

## Análise

Acompanhe o desempenho da Gestão a partir da aba **Recuperação** na seção **Análise** do seu painel.

<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 entradas de gestão, taxas de sucesso, receita recuperada e detalhamento de desempenho por e-mail" style={{ maxHeight: '500px', width: 'auto' }} width="2548" height="2190" data-path="images/recovery/recovery-analytics.png" />
</Frame>

| Métrica                       | Descrição                                                          |
| ----------------------------- | ------------------------------------------------------------------ |
| **Entradas de Gestão**        | Número total de tentativas de gestão criadas                       |
| **Taxa de Sucesso**           | Porcentagem de tentativas de gestão que levaram à recuperação      |
| **Receita Recuperada**        | Receita total recuperada através da gestão                         |
| **Recuperação por Tentativa** | Detalhamento de qual e-mail na sequência impulsionou a recuperação |

## Eventos de Webhook

| Evento              | Descrição                                               |
| ------------------- | ------------------------------------------------------- |
| `dunning.started`   | Uma tentativa de gestão foi iniciada para uma inscrição |
| `dunning.recovered` | Uma inscrição foi recuperada através da gestã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 gestão.
</Card>

## Casos de Uso Excepcionais

| Cenário                                                       | Comportamento                                                                     |
| ------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Cliente atualiza método de pagamento antes de qualquer e-mail | Recuperação é detectada; tentativa de gestão é marcada como recuperada            |
| Cliente compra outra inscrição do mesmo negócio               | Tentativa de gestão é marcada como esgotada                                       |
| Todos os e-mails de gestão esgotados                          | Tentativa de gestão é marcada como esgotada; estado da inscrição não é modificado |

## Melhores Práticas

* **Comece com os padrões**: O tempo padrão do e-mail é projetado com espaçamento razoável (1, 3, 5 e 7 dias) para evitar sobrecarregar os clientes enquanto mantém a urgência.
* **Monitore taxas de sucesso**: Acompanhe qual e-mail na sequência impulsiona mais recuperações. Se e-mails posteriores tiverem conversão quase nula, considere desativá-los.
* **Coordene com o suporte**: Certifique-se de que sua equipe de suporte saiba que os e-mails de gestão estão sendo enviados para que possam ajudar os clientes que entrarem em contato.
* **Revise estados da inscrição**: Emparelhe a gestão com `subscription.on_hold` e `subscription.cancelled` webhooks para acompanhamento abrangente do ciclo de vida.

<Info>
  A gestão funciona juntamente com os fluxos existentes de inscrição em espera e reativação no portal do cliente. Uma vez ativada, ela funciona automaticamente sem necessidade de integração adicional.
</Info>

## Relacionados

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

  <Card title="Abandoned Cart Recovery" icon="cart-shopping" href="/features/recovery/abandoned-cart-recovery">
    Recupere checkouts incompletos ou falhos com e-mails direcionados.
  </Card>

  <Card title="Customer Portal" icon="id-card" href="/features/customer-portal">
    Clientes atualizam métodos de pagamento pelo portal do cliente.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    Entenda os estados de inscrição que acionam os fluxos de trabalho de gestão.
  </Card>
</CardGroup>
