Pular para o conteúdo

Automatizar

Recupere carrinhos abandonados

Envie um email de lembrete quando um cliente deixa um carrinho e não faz um pedido no dia seguinte.

No final, você terá uma automação que espera depois de cada evento de carrinho, verifica se houve um pedido e manda ao cliente um email com os itens que ele deixou para trás.

Antes de começar

  • Uma chave API com escrita em Contatos, criada em Configurações → Equipe e chaves API. Os eventos personalizados dependem da permissão de Contatos.
  • O ID do seu workspace e o endereço da sua instância do Notifuse (YOUR_HOST nos exemplos).
  • Uma lista para a automação, como a lista da sua newsletter. Sem ela, uma automação não aceita um nó de Email.
  • Um provedor de email definido para Emails de marketing.

Configure a recuperação de carrinhos

  1. Envie um evento de carrinho pela sua loja

    Quando um cliente cria um carrinho, envie um evento personalizado para POST /api/customEvents.import. O corpo traz o seu workspace_id e um array events com 1 a 50 eventos.

    Cada evento precisa de:

    • external_id: o ID do carrinho na sua loja. Um external_id novo inicia a automação. Enviar o mesmo de novo atualiza o evento gravado e não inicia nada.
    • email: o endereço do cliente.
    • event_name: letras minúsculas, números, _, ., / e -, com no máximo 100 caracteres. Este guia usa cart.created.
    • properties: o que o email vai mostrar, como os itens e um link de volta para o carrinho.

    occurred_at é opcional e, por padrão, vale o momento atual. Não dê um goal_type ao evento de carrinho.

    cURL

    curl -X POST https://YOUR_HOST/api/customEvents.import \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "workspace_id": "YOUR_WORKSPACE_ID",
        "events": [
          {
            "external_id": "cart_8f3a2c",
            "email": "jane@example.com",
            "event_name": "cart.created",
            "properties": {
              "cart_url": "https://shop.example.com/cart/8f3a2c",
              "total": 89.9,
              "items": [
                { "name": "Linen shirt", "quantity": 1, "price": 59.9 },
                { "name": "Canvas tote", "quantity": 1, "price": 30.0 }
              ]
            }
          }
        ]
      }'

    Node.js

    const response = await fetch('https://YOUR_HOST/api/customEvents.import', {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.NOTIFUSE_API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        workspace_id: 'YOUR_WORKSPACE_ID',
        events: [
          {
            external_id: `cart_${cart.id}`,
            email: cart.email,
            event_name: 'cart.created',
            properties: {
              cart_url: cart.url,
              total: cart.total,
              items: cart.items.map((item) => ({
                name: item.name,
                quantity: item.quantity,
                price: item.price
              }))
            }
          }
        ]
      })
    })
    
    if (!response.ok) {
      throw new Error(`Notifuse returned ${response.status}: ${await response.text()}`)
    }

    Python

    import os
    import requests
    
    response = requests.post(
        "https://YOUR_HOST/api/customEvents.import",
        headers={"Authorization": f"Bearer {os.environ['NOTIFUSE_API_KEY']}"},
        json={
            "workspace_id": "YOUR_WORKSPACE_ID",
            "events": [
                {
                    "external_id": f"cart_{cart['id']}",
                    "email": cart["email"],
                    "event_name": "cart.created",
                    "properties": {
                        "cart_url": cart["url"],
                        "total": cart["total"],
                        "items": [
                            {"name": i["name"], "quantity": i["quantity"], "price": i["price"]}
                            for i in cart["items"]
                        ],
                    },
                }
            ],
        },
    )
    response.raise_for_status()

    O Notifuse não cria um contato a partir de um evento, e uma jornada não consegue executar suas etapas sem um contato. Se o cliente talvez ainda não seja um contato, crie-o antes com POST /api/contacts.upsert.

    O email mostra o carrinho como ele estava quando esse primeiro evento chegou. As atualizações enviadas depois com o mesmo external_id mudam o evento gravado, mas não a jornada que já começou.

  2. Envie os pedidos como metas de compra

    A automação verifica se houve um pedido com uma condição de Meta, e uma condição de meta só conta eventos que têm um goal_type. Envie cada pedido com goal_type: "purchase" e o valor em goal_value, que é obrigatório para compras.

    cURL

    curl -X POST https://YOUR_HOST/api/customEvents.import \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "workspace_id": "YOUR_WORKSPACE_ID",
        "events": [
          {
            "external_id": "order_1042",
            "email": "jane@example.com",
            "event_name": "order.completed",
            "goal_type": "purchase",
            "goal_value": 89.9,
            "properties": { "cart_id": "8f3a2c" }
          }
        ]
      }'

    Node.js

    await fetch('https://YOUR_HOST/api/customEvents.import', {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.NOTIFUSE_API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        workspace_id: 'YOUR_WORKSPACE_ID',
        events: [
          {
            external_id: `order_${order.id}`,
            email: order.email,
            event_name: 'order.completed',
            goal_type: 'purchase',
            goal_value: order.total,
            properties: { cart_id: order.cartId }
          }
        ]
      })
    })

    Python

    requests.post(
        "https://YOUR_HOST/api/customEvents.import",
        headers={"Authorization": f"Bearer {os.environ['NOTIFUSE_API_KEY']}"},
        json={
            "workspace_id": "YOUR_WORKSPACE_ID",
            "events": [
                {
                    "external_id": f"order_{order['id']}",
                    "email": order["email"],
                    "event_name": "order.completed",
                    "goal_type": "purchase",
                    "goal_value": order["total"],
                    "properties": {"cart_id": order["cart_id"]},
                }
            ],
        },
    ).raise_for_status()

    O Notifuse não liga um pedido a um carrinho. A propriedade cart_id só serve para os seus próprios registros.

  3. Escreva o email de lembrete

    Crie um template na categoria Marketing. O evento que iniciou a jornada fica disponível como trigger_event, com as propriedades do carrinho em trigger_event.properties:

    <p>Hi {{ contact.first_name | default: "there" }}, you left these in your cart:</p>
    {% for item in trigger_event.properties.items %}
      <p>{{ item.quantity }} × {{ item.name }}: {{ item.price }}</p>
    {% endfor %}
    <p><a href="{{ trigger_event.properties.cart_url }}">Back to your cart</a></p>
  4. Crie a automação

    Vá em Automacoes e clique em Nova automação. Em Configurações, à esquerda, escolha a Lista e defina a Frequência:

    • Toda vez: cada carrinho novo inicia a sua própria jornada.
    • Uma vez por contato: só o primeiro carrinho de um contato recebe um lembrete.

    No gatilho, defina Evento de Gatilho como Evento personalizado e Nome do Evento como cart.created.

  5. Adicione um Atraso

    Adicione uma etapa de Atraso depois do gatilho. Defina Duração da Espera como 1 e a unidade como Dias.

    A próxima etapa explica por que uma espera de 1 dia é a que melhor combina com a verificação do pedido.

  6. Adicione um Filtro que procura um pedido

    Adicione uma etapa de Filtro depois do Atraso e clique em Adicionar condições de filtro. Adicione uma Condição do tipo Meta e preencha:

    • O contato: não atingiu, Compra.
    • Medida: contagem, maior ou igual a, 1.
    • Quando: nos últimos 1 dias.

    Clique em Confirmar. Os contatos que atendem à condição seguem o caminho Sim. Deixe o Não vazio: um cliente que fez o pedido termina a jornada ali.

    A etapa de Filtro de uma automação de carrinho, com a condição e quantos contatos seguiram cada caminho
    A etapa de Filtro de uma automação de carrinho, com a condição e quantos contatos seguiram cada caminho

    Nota

    O Filtro não consegue verificar “nenhum pedido desde este carrinho”. A janela da meta conta dias inteiros para trás a partir do momento em que o Filtro roda, e não pode começar no evento de carrinho.

    Com um Atraso de 1 dia e uma janela de 1 dia, os dois se alinham: o Filtro olha para trás até mais ou menos a hora em que o evento de carrinho chegou. Um Atraso mais curto com a mesma janela olha para antes do carrinho. Com um Atraso de 4 horas, um cliente que fez um pedido nas 20 horas anteriores à criação do carrinho é tratado como comprador e não recebe lembrete.

    A janela também conta todas as compras, então um pedido de algo totalmente diferente também impede o lembrete.

    O Filtro também é o lugar para limitar o email aos inscritos. Contatos que nunca estiveram na lista da automação recebem mesmo assim um email de marketing; só ficam de fora os que cancelaram a inscrição, geraram rejeição ou reclamaram nessa lista. Para enviar só aos membros da lista, adicione uma condição de Inscrição na lista junto com a de Meta.

  7. Adicione a etapa de Email e ative

    Adicione uma etapa de Email no caminho Sim e escolha o seu lembrete em Template de Email.

    Clique em Ativar e depois em Sim, ativar. Só os carrinhos que chegarem a partir desse momento iniciam uma jornada.

    Uma automação de recuperação de carrinho: gatilho de evento personalizado, atraso e depois um filtro nas compras recentes
    Uma automação de recuperação de carrinho: gatilho de evento personalizado, atraso e depois um filtro nas compras recentes

Confira se funciona

  1. Defina o Atraso como alguns Minutos enquanto testa.
  2. Envie um evento cart.created para o seu próprio endereço, com um external_id que você ainda não usou.
  3. Abra o seu contato em Contatos, vá na aba Atividade e escolha o filtro Eventos. Você deve ver o evento de carrinho e “Entrou na automação”.
  4. Quando o atraso termina, o lembrete chega e a atividade mostra “Concluiu a automação”.
  5. Envie um segundo carrinho e depois um evento de compra antes do fim do atraso. Essa jornada termina no Filtro e nenhum email sai.

Volte o Atraso para 1 dia antes de os carrinhos reais começarem a chegar.

Próximos passos