---
title: "Recuperação de Carrinho Abandonado"
description: "Recupere vendas perdidas com uma sequência inteligente de e-mails em várias etapas que traz os clientes de volta para concluir a compra."
url: https://tajo.io/pt/docs/skills/email-marketing/abandoned-cart/
markdown: https://tajo.io/pt/docs/skills/email-marketing/abandoned-cart.md
lang: pt-BR
robots: noindex
---

Solicite acesso antecipado

Indique o seu nome e endereço de e-mail profissional. Enviaremos um link para confirmar o seu pedido de acesso ao Tajo.

# Recuperação de Carrinho Abandonado

Recupere vendas perdidas com uma sequência inteligente de e-mails em várias etapas. Esta skill monitora o abandono de carrinho e envia automaticamente e-mails de recuperação personalizados para trazer os clientes de volta.

## Visão Geral

| Propriedade | Valor |
| --- | --- |
| **Categoria** | Email Marketing |
| **Status** | Estável |
| **Versão** | 3.0 |
| **Triggers** | `cart_abandoned`, `cart_recovered` |
| **Taxa Média de Recuperação** | 10-15% |

## Como Funciona

```mermaid
graph TD
    A[Customer adds to cart] -->|Leaves site| B{Cart abandoned?}
    B -->|No checkout in 30min| C[Trigger: cart_abandoned]
    C --> D[Wait 1 hour]
    D --> E{Purchased?}
    E -->|No| F[Send Email #1]
    F --> G[Wait 24 hours]
    G --> H{Purchased?}
    H -->|No| I[Send Email #2 + Discount]
    I --> J[Wait 48 hours]
    J --> K{Purchased?}
    K -->|No| L[Send Email #3 - Final]
    E -->|Yes| M[Stop sequence]
    H -->|Yes| M
    K -->|Yes| M
    L --> N[Mark as lost]
```

## Configuração

### Configuração Básica

```yaml
skills:
  abandoned-cart:
    enabled: true

    # Cart abandonment detection
    detection:
      inactivity_threshold: 30m  # Minutes before cart is abandoned
      min_cart_value: 25         # Minimum cart value to trigger
      exclude_logged_out: false  # Include guest carts

    # Email sequence
    sequence:
      - delay: 1h
        template_id: 101
        subject: "Forgot something?"

      - delay: 24h
        template_id: 102
        subject: "Your cart is waiting"
        include_discount: true
        discount_percent: 10

      - delay: 48h
        template_id: 103
        subject: "Last chance - items selling fast"
        include_discount: true
        discount_percent: 15
        discount_expiry: 24h

    # Stop conditions
    stop_on:
      - cart_recovered
      - order_placed
      - unsubscribe
```

### Configuração Avançada

```yaml
skills:
  abandoned-cart:
    # Segment-specific timing
    timing:
      vip_customers:
        first_email: 30m
        discount_threshold: 0  # Always include discount
      new_customers:
        first_email: 2h
        discount_threshold: 50  # Discount only if cart > $50
      repeat_customers:
        first_email: 1h
        discount_threshold: 100

    # A/B testing
    ab_testing:
      enabled: true
      variants:
        - name: "urgency"
          subject: "Items in your cart are selling fast!"
          weight: 50
        - name: "friendly"
          subject: "Did you forget something?"
          weight: 50

    # Exclusions
    exclude:
      - email_domain: ["temp-mail.com", "disposable.com"]
      - customer_tag: ["wholesale", "staff"]
      - product_category: ["gift-cards"]
```

## Triggers

### cart\_abandoned

Dispara quando um carrinho está inativo pelo tempo configurado.

#### Dados do Evento

| Parameter | Type | Description |
| --- | --- | --- |
| `cart_id` required | string | Identificador único do carrinho |
| `customer_email` required | string | Endereço de e-mail do cliente |
| `items` required | array | Array de itens do carrinho com nome, preço, quantidade, image\_url |
| `total` required | number | Valor total do carrinho |
| `currency` optional | string | Código da moeda (ex.: USD, EUR) Default: `USD` |
| `recovery_url` required | string | URL para recuperar o carrinho |
| `abandoned_at` required | datetime | Quando o carrinho foi abandonado |

Exemplo de payload:

```json
{
  "event": "cart_abandoned",
  "timestamp": "2024-01-15T14:30:00Z",
  "data": {
    "cart_id": "cart_abc123",
    "customer_email": "jane@example.com",
    "items": [
      {
        "id": "prod_123",
        "name": "Premium Headphones",
        "price": 199.99,
        "quantity": 1,
        "image_url": "https://cdn.example.com/headphones.jpg",
        "variant": "Black"
      },
      {
        "id": "prod_456",
        "name": "Phone Case",
        "price": 29.99,
        "quantity": 2,
        "image_url": "https://cdn.example.com/case.jpg"
      }
    ],
    "subtotal": 259.97,
    "shipping": 0,
    "tax": 20.80,
    "total": 280.77,
    "currency": "USD",
    "recovery_url": "https://store.example.com/cart/recover/abc123",
    "abandoned_at": "2024-01-15T14:00:00Z"
  }
}
```

### cart\_recovered

Dispara quando um cliente retorna e conclui o checkout.

```json
{
  "event": "cart_recovered",
  "timestamp": "2024-01-15T16:45:00Z",
  "data": {
    "cart_id": "cart_abc123",
    "customer_email": "jane@example.com",
    "order_id": "order_789",
    "recovered_via": "email_1",  // Which email triggered recovery
    "time_to_recover": "2h15m"
  }
}
```

## Templates de E-mail

### Variáveis de Template

Use estas variáveis nos seus templates de e-mail do Brevo:

| Variável | Descrição | Exemplo |
| --- | --- | --- |
| `params.FIRSTNAME` | Primeiro nome do cliente | Jane |
| `params.CART_URL` | URL de recuperação do carrinho | https://… |
| `params.CART_TOTAL` | Total do carrinho formatado | $280.77 |
| `params.ITEM_COUNT` | Número de itens | 3 |
| `params.ITEMS` | Array JSON de itens | \[…\] |
| `params.DISCOUNT_CODE` | Código de desconto gerado | SAVE10-ABC |
| `params.DISCOUNT_PERCENT` | Percentual de desconto | 10 |
| `params.EXPIRY_DATE` | Data de expiração do desconto | Jan 17, 2024 |

### Sequência de E-mails Recomendada

**E-mail 1 (1 hora)**: Lembrete amigável

- Assunto: “Esqueceu algo, {{ params.FIRSTNAME }}?”
- Foco: Lembrar sobre o conteúdo do carrinho
- Ainda sem desconto

**E-mail 2 (24 horas)**: Adicionar urgência + incentivo

- Assunto: “Seu carrinho está esperando + 10% de desconto”
- Foco: Desconto por tempo limitado
- Incluir código de desconto

**E-mail 3 (48 horas)**: Empurrão final

- Assunto: “Última chance - 15% de desconto expira em breve”
- Foco: Escassez + desconto maior
- Expiração de 24 horas no desconto

## Exemplos de Código

### Ativar a Skill de Carrinho Abandonado

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

await tajo.skills.enable('abandoned-cart', {
  detection: {
    inactivityThreshold: '30m',
    minCartValue: 25
  },
  sequence: [
    { delay: '1h', templateId: 101 },
    { delay: '24h', templateId: 102, discountPercent: 10 },
    { delay: '48h', templateId: 103, discountPercent: 15 }
  ]
});
```

### Rastrear Abandono de Carrinho

```javascript
// Call this when cart activity is detected
await tajo.events.track('cart_updated', {
  cartId: 'cart_abc123',
  customerEmail: 'jane@example.com',
  items: cartItems,
  total: 280.77
});

// Call this when customer leaves without checkout
// (typically from a beforeunload event or session timeout)
await tajo.events.track('cart_abandoned', {
  cartId: 'cart_abc123',
  customerEmail: 'jane@example.com',
  items: cartItems,
  total: 280.77,
  recoveryUrl: 'https://store.example.com/cart/recover/abc123'
});
```

### Gerar Códigos de Desconto

```javascript
// Generate a unique discount code
const discount = await tajo.discounts.create({
  type: 'percentage',
  value: 10,
  expiresIn: '7d',
  usageLimit: 1,
  prefix: 'SAVE10'
});

// discount.code => "SAVE10-ABC123"
```

## Analytics

Acompanhe o desempenho da recuperação de carrinho abandonado:

| Métrica | Descrição |
| --- | --- |
| **Taxa de Abandono** | % de carrinhos abandonados |
| **Taxa de Recuperação** | % de carrinhos abandonados recuperados |
| **Receita Recuperada** | Receita total de carrinhos recuperados |
| **Taxa de Abertura de E-mail** | % de e-mails de recuperação abertos |
| **CTR do E-mail** | Taxa de cliques nos e-mails de recuperação |
| **Tempo até Recuperação** | Tempo médio do abandono até a compra |

```javascript
const stats = await tajo.skills.getStats('abandoned-cart', {
  period: '30d'
});

console.log(stats);
// {
//   abandonmentRate: 68.5,
//   recoveryRate: 12.3,
//   revenueRecovered: 15420.50,
//   emailsSent: 2340,
//   emailOpenRate: 45.2,
//   emailCtr: 8.7,
//   avgTimeToRecovery: '4h32m'
// }
```

## Boas Práticas

O Timing Importa

Envie o primeiro e-mail dentro de 1-2 horas do abandono. As taxas de recuperação caem significativamente após 24 horas.

1. **Personalize as linhas de assunto** - Use o nome do cliente e o conteúdo do carrinho
2. **Mostre o conteúdo do carrinho** - Inclua imagens dos produtos no e-mail
3. **Crie urgência** - Mencione estoque baixo ou descontos por tempo limitado
4. **Facilite a recuperação** - Links de recuperação de carrinho em um clique
5. **Teste sua sequência** - Faça testes A/B de timing, assuntos e descontos
6. **Respeite os descadastros** - Pare a sequência imediatamente ao receber descadastro

## Skills Relacionadas

- Eventos de Carrinho - Acompanhe atividade no carrinho
- Abandono de Navegação - Recupere sessões de navegação
- Reconquista - Reengaje clientes inativos

## Próximos Passos

1. Configure o rastreamento do carrinho na sua plataforma
2. Crie templates de e-mail no Brevo
3. Configure a integração de códigos de desconto
4. Monitore o desempenho no dashboard