---
title: "Integração Nuvemshop: recuperar carrinho abandonado"
description: "Integre a Nuvemshop ao Datacrazy para identificar e recuperar carrinhos abandonados: crie o app, obtenha as credenciais e configure o checkout."
url: https://help.datacrazy.io/pt-br/articles/10670837-integracao-nuvemshop-recuperar-carrinho-abandonado
collection: "Integrações"
updated: 2026-11-18
language: pt-br
---

# Integração Nuvemshop: recuperar carrinho abandonado

Integre a Nuvemshop ao Datacrazy para identificar e recuperar carrinhos abandonados: crie o app, obtenha as credenciais e configure o checkout.

Esta integração permite consultar os carrinhos abandonados da Nuvemshop diretamente pelo CRM DataCrazy, identificar os clientes e automatizar ações de recuperação, como o envio de mensagens pelo WhatsApp.

O processo utiliza a API da Nuvemshop para buscar os carrinhos abandonados e uma automação no DataCrazy para organizar as informações e processar individualmente cada contato.

O fluxo de automação ficará disponível para download e poderá ser personalizado conforme a necessidade de cada operação.

* * *

## 1\. Pré-requisitos

### 1.1. Criar um aplicativo sob medida

Para permitir a comunicação entre a Nuvemshop e o DataCrazy, será necessário criar um aplicativo com acesso à API da loja.

No painel administrativo da Nuvemshop, acesse:

**Aplicativos → Aplicativos sob medida**

Crie um aplicativo e conceda a seguinte permissão:

-   **Ler Pedidos**
    

Essa permissão permite consultar as informações dos carrinhos abandonados.

### 1.2. Obter as credenciais

Após criar o aplicativo, identifique as seguintes informações:

<table data-id="f9cbd5b9-de48-432f-a76e-1cf6e3f31909" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p data-id="fc1ee179-f95e-4cc2-a25a-14367ace3715">Informação</p></th><th colspan="1" rowspan="1"><p data-id="c78c7704-691e-466c-949c-e9cfdca24999">Finalidade</p></th></tr><tr><td colspan="1" rowspan="1"><p data-id="13224ee4-e8cb-4766-9294-20c7b5c31463">ID da loja</p></td><td colspan="1" rowspan="1"><p data-id="1ef13deb-3e5c-4054-9028-f1b918daa086">Identificar a loja nas requisições da API</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="48cea058-839b-44c2-afc7-698bb6e93f4b">Token de acesso</p></td><td colspan="1" rowspan="1"><p data-id="af564990-3fec-4bdf-8aa3-58ab43af86c4">Autorizar a consulta aos dados da Nuvemshop</p></td></tr></tbody></table>

Essas informações serão utilizadas na configuração do bloco de requisição HTTP.

**Importante:** o token de acesso é uma informação sensível e deve ser armazenado de forma segura.

### 1.3. Tornar o telefone obrigatório no checkout

Para que o DataCrazy consiga identificar os clientes e realizar ações de recuperação pelo WhatsApp, é importante que o telefone seja preenchido durante o checkout.

Na Nuvemshop, acesse:

**Configurações → Opções de Checkout → Dados do Cliente →** Ative a opção **Pedir Telefone de Contato** e salve as alterações.

Com essa configuração, o cliente deverá informar um número de telefone com DDD para prosseguir com a compra.

### 1.4. Baixar e importar o fluxo

O fluxo de automação está disponível para download: ⬇ [Carrinho Abandonado NuvemShop](https://drive.google.com/drive/folders/1OWXtnQIHOJ7v7IW6Pc9yI2STPjALAMxv)

Após baixar o arquivo, acesse a área de **Automações** do DataCrazy, utilize a opção de importação e selecione o arquivo disponibilizado.

Depois de importar, abra a automação para configurar as credenciais da Nuvemshop, conferir os campos utilizados e personalizar as ações.

* * *

## 2\. Como funciona a consulta de carrinhos abandonados?

A integração utiliza o endpoint `/checkouts` da Nuvemshop para consultar os carrinhos classificados como abandonados.

**É importante considerar que a Nuvemshop pode levar até 6 horas para identificar e disponibilizar um carrinho abandonado na API.**

Isso significa que um checkout recém-abandonado pode não aparecer imediatamente na consulta.

Por esse motivo, o fluxo utiliza um intervalo de busca maior, permitindo consultar carrinhos criados algumas horas antes da execução.

A automação é composta por dois blocos JavaScript, uma requisição HTTP e um Loop de Array, responsáveis por preparar, consultar e organizar os registros antes das ações de identificação dos leads.

* * *

## 3\. JavaScript — Definição do período de consulta

### Para que serve?

O primeiro JavaScript calcula automaticamente a data correspondente a **7 horas antes do momento da execução**.

Essa informação é armazenada na variável `dataMinima`, que será utilizada como filtro na requisição à Nuvemshop.

### Por que utilizar esse bloco?

Em vez de consultar todos os carrinhos abandonados da loja, a automação busca apenas aqueles criados dentro de um período definido.

O JavaScript permite que esse intervalo seja atualizado automaticamente a cada execução, sem precisar informar uma data manualmente.

Por exemplo, se o fluxo executar às 15h, o período será calculado a partir das 8h. Na próxima execução, esse horário será atualizado.

O intervalo de 7 horas foi definido considerando o prazo de até 6 horas para a Nuvemshop disponibilizar os carrinhos abandonados, com uma margem adicional.

**Atenção:** o período pode ser ajustado conforme a necessidade da operação. Como o filtro utiliza a data de criação do checkout, carrinhos disponibilizados após essa janela poderão não ser incluídos na consulta.

* * *

## 4\. Requisição HTTP — Consulta à Nuvemshop

### Para que serve?

Este bloco realiza a comunicação com a API da Nuvemshop e consulta os carrinhos abandonados conforme os parâmetros definidos.

No DataCrazy, é utilizado o bloco **Requisição HTTP com comunicação via JSON**.

### Configuração da requisição

**Método:** `GET`

**Endpoint:**

```javascript
<https://api.nuvemshop.com.br/2025-03/{id_loja}/checkouts>

```

Substitua `{id_loja}` pelo ID da loja obtido durante a criação do aplicativo.

### Cabeçalhos

Na seção **Cabeçalho**, configure:

<table data-id="bd7444cb-3ca3-4839-8712-cf0e4f460e49" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p data-id="070e3145-a4b3-4010-b152-3e9ca1f6d872">Chave</p></th><th colspan="1" rowspan="1"><p data-id="d5e1910f-87d2-440d-8836-14e181cb625b">Valor</p></th></tr><tr><td colspan="1" rowspan="1"><p data-id="27afa836-f6e2-4d90-b69e-df63d37d433c"><code>Authorization</code></p></td><td colspan="1" rowspan="1"><p data-id="e683de18-1616-4c7c-9a95-ada443a9f8e2"><code>Bearer SEU_TOKEN</code></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="d7475fdc-c787-463a-8696-a7d30f5c0460"><code>Content-Type</code></p></td><td colspan="1" rowspan="1"><p data-id="d96af462-ff56-41b7-92be-23fea840eebd"><code>application/json</code></p></td></tr></tbody></table>

Substitua os valores de exemplo pelas informações do aplicativo criado na Nuvemshop.

### Parâmetros da requisição

Na seção **Parâmetros**, utilize:

<table data-id="4f522e86-80bf-407d-86b7-2a19706ffaf9" style="min-width: 199px;"><colgroup><col style="width: 39.48%;"><col style="width: 21.05%;"><col style="width: 39.48%;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p data-id="d8712c16-80ba-432c-9331-20825f41fa3a">Parâmetro</p></th><th colspan="1" rowspan="1"><p data-id="23756e5d-8271-4e1e-a814-e86cd9246f9f">Valor</p></th><th colspan="1" rowspan="1"><p data-id="f77a49ca-1e1e-4589-b61c-35461ac96be0">Finalidade</p></th></tr><tr><td colspan="1" rowspan="1"><p data-id="a6f0dfec-5db4-43a9-9813-42a95cb696b8"><code>created_at_min</code></p></td><td colspan="1" rowspan="1"><p data-id="353cbafb-c50f-450c-a0b0-fc1a6c879a4a"><code>dataMinima</code></p></td><td colspan="1" rowspan="1"><p data-id="59896974-6e1c-4d3a-ba98-b18b157429ce">Filtrar os carrinhos pela data de criação</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="695a8a0e-e342-4ecd-b7be-5f4e9488deab"><code>per_page</code></p></td><td colspan="1" rowspan="1"><p data-id="259f14ae-da9f-472a-a0c5-011c85c4325a"><code>50</code></p></td><td colspan="1" rowspan="1"><p data-id="704e7cd7-dd31-4f32-b3d3-befa00bd601c">Definir a quantidade máxima de carrinhos retornados</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="2938cecd-6997-4218-b764-a93b7d148e00"><code>fields</code></p></td><td colspan="1" rowspan="1"><p data-id="00c25ae4-1c93-42ae-81b2-bcec34d2fdbc">Campos específicos</p></td><td colspan="1" rowspan="1"><p data-id="11608d85-c0cb-4e0f-bec9-ce5915c5413b">Limitar as informações retornadas</p></td></tr></tbody></table>

No parâmetro `created_at_min`, selecione a variável `dataMinima` disponibilizada pelo primeiro JavaScript.

### Por que utilizamos o parâmetro `fields`?

O retorno completo da API da Nuvemshop contém muitas informações, incluindo dados de produtos, imagens, endereços, pagamentos e outras propriedades do checkout.

Como esses dados tornam o JSON consideravelmente maior, utilizamos o parâmetro `fields` para solicitar somente as informações necessárias ao processamento no DataCrazy.

**Campos configurados:**

```javascript
id,contact_name,contact_phone,abandoned_checkout_url

```

<table data-id="d61ce403-1110-49f5-bc2c-64554f09ad6c" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p data-id="4d92d653-18e7-4f59-b548-86c99175a3f1">Campo</p></th><th colspan="1" rowspan="1"><p data-id="4cfdeada-3a3a-4de5-8e49-b5e6a77e5e12">Finalidade</p></th></tr><tr><td colspan="1" rowspan="1"><p data-id="cbb802ce-fe98-4cb6-9a76-f932b197502f"><code>id</code></p></td><td colspan="1" rowspan="1"><p data-id="38ffa992-873f-4029-8236-515d8bb2905d">Identificar individualmente o carrinho abandonado</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="d98f4cf3-09c5-4412-a09b-fe00819d3590"><code>contact_name</code></p></td><td colspan="1" rowspan="1"><p data-id="f52e1713-8e30-4583-b854-e7db8b7be26a">Obter o nome do cliente</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="b7e666bc-5f2a-4cf0-8e49-067c73356df1"><code>contact_phone</code></p></td><td colspan="1" rowspan="1"><p data-id="b0e9783b-7f97-48fc-82f2-8cc1b4c35cf6">Obter o telefone para identificar o lead</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="75192791-df99-42aa-a486-841fb1665e4f"><code>abandoned_checkout_url</code></p></td><td colspan="1" rowspan="1"><p data-id="b3d45ea9-57db-473e-9a1f-38270cc4665c">Obter o link para retomar a compra</p></td></tr></tbody></table>

Essa configuração reduz o tamanho da resposta e facilita a utilização das informações nos próximos blocos da automação.

### Personalização dos campos retornados

Caso seja necessário obter informações adicionais dos carrinhos, é possível personalizar o parâmetro `fields` conforme a necessidade da integração.

Para isso, consulte a [documentação oficial da API da Nuvemshop](https://nuvemshop.dev/api/getting-started) e verifique os campos disponibilizados pelo recurso de carrinhos abandonados (`/checkouts`).

Depois, adicione ao parâmetro `fields` os nomes dos campos desejados, separados por vírgula.

**Importante:** incluir mais campos aumenta o tamanho do JSON retornado. Por isso, recomenda-se selecionar somente as informações que serão utilizadas na automação e ajustar os mapeamentos do DataCrazy quando necessário.

### Quantidade de registros — `per_page`

O parâmetro `per_page` define quantos carrinhos podem ser retornados por página.

No fluxo disponibilizado, utilizamos `per_page=50`, aproveitando a redução do JSON proporcionada pelo parâmetro `fields`.

O valor 50 pode ser ajustado conforme o volume de dados e a capacidade de processamento do ambiente.

### Paginação para lojas com maior volume de carrinhos

Para lojas com um volume elevado de carrinhos abandonados, é recomendável avaliar a implementação de **paginação na requisição**.

A Nuvemshop disponibiliza o parâmetro `page`, que permite consultar os resultados em páginas diferentes, respeitando o limite definido em `per_page`.

Por exemplo, considerando `per_page=50`:

-   `page=1` — consulta os primeiros 50 registros.
    
-   `page=2` — consulta os próximos 50 registros.
    
-   `page=3` — consulta a terceira página de resultados.
    

**O fluxo disponibilizado não possui controle automático de paginação.** Portanto, caso a loja tenha mais carrinhos do que o limite retornado por requisição, será necessário adaptar a automação para consultar e processar as páginas seguintes.

Essa configuração é especialmente importante para operações com grande volume de pedidos, evitando que carrinhos deixem de ser considerados na recuperação.

* * *

## 5\. JavaScript — Organização do JSON

### Para que serve?

O segundo JavaScript organiza os dados retornados pela Nuvemshop para que possam ser utilizados corretamente no bloco **Loop de Array**.

A API retorna os carrinhos diretamente em uma lista JSON. Entretanto, o seletor de variáveis do DataCrazy pode não permitir a seleção dessa lista completa quando ela está na raiz da resposta.

Para resolver isso, o JavaScript coloca os registros dentro de uma propriedade chamada `carrinhos`.

### Como funciona?

O bloco recebe a resposta da API, verifica se os dados estão no formato esperado e organiza os registros em uma estrutura que o Loop consiga utilizar.

Além disso, disponibiliza a propriedade `total`, que informa a quantidade de carrinhos retornados.

**Exemplo simplificado da estrutura organizada:**

```javascript
{
  "carrinhos": [
    { "id": 123456 },
    { "id": 789012 }
  ],
  "total": 2
}

```

Essa transformação não altera as informações dos carrinhos. Ela apenas organiza o retorno para facilitar o processamento nos blocos seguintes.

* * *

## 6\. Loop de Array — Processamento individual

### Para que serve?

O **Loop de Array** permite percorrer individualmente os carrinhos retornados pela Nuvemshop.

Assim, mesmo que a consulta retorne vários registros, a automação poderá executar as próximas ações separadamente para cada cliente.

### Configuração

No parâmetro do Loop, selecione a propriedade `carrinhos`, disponibilizada pelo JavaScript anterior.

O bloco utilizará essa lista para processar cada registro individualmente, disponibilizando informações como nome, telefone, ID do checkout e link de recuperação.

Por exemplo, se a API retornar 10 carrinhos, o Loop permitirá que os próximos blocos tratem cada um desses 10 registros.

**Importante:** em consultas com muitos registros, considere os limites de iteração do bloco Array e utilize pausas quando necessário para evitar falhas de processamento.

* * *

## 7\. Identificação e organização dos leads

Após o Loop, a automação utiliza o telefone de cada carrinho para identificar o cliente correspondente no DataCrazy.

### Verificação e criação do lead

O fluxo verifica se já existe um lead cadastrado com o telefone informado no checkout.

-   **Se o lead existir:** utiliza o cadastro correspondente, evitando a criação de contatos duplicados.
    
-   **Se não existir:** utiliza os blocos de Mapeamento de Campos e Criação de Lead para cadastrar o cliente com as informações recebidas da Nuvemshop.
    

Os principais campos utilizados nessa etapa são `contact_name` e `contact_phone`.

Essa estrutura pode ser personalizada caso seja necessário adicionar informações, condições ou ações específicas.

### Aplicação de etiqueta

Após identificar ou criar o lead, o fluxo pode aplicar uma etiqueta como **Carrinho Abandonado**.

A etiqueta é importante para identificar a origem desses contatos no CRM, facilitar a segmentação e permitir a criação de outras automações e estratégias de recuperação.

Por exemplo, ela pode ser utilizada para organizar os leads em uma pipeline específica ou identificar aqueles que precisam receber acompanhamento.

**Observação:** a etiqueta identifica o lead, mas não diferencia seus carrinhos. Caso a recuperação seja realizada individualmente por checkout, recomenda-se utilizar o campo `id` para controlar os carrinhos que já foram processados, evitando mensagens duplicadas.

### Personalização das ações

A partir dessa etapa, é possível adicionar outras ações conforme a necessidade, como envio de mensagens pelo WhatsApp, movimentações de pipeline ou condições adicionais.

O campo `abandoned_checkout_url` poderá ser utilizado nas mensagens para permitir que o cliente retome a compra.

Antes do envio, é importante confirmar que as ações estão vinculadas ao lead correto e que o carrinho ainda pode ser recuperado.

* * *

## 8\. Considerações importantes

**Prazo de identificação:** a Nuvemshop pode levar até 6 horas para disponibilizar um carrinho abandonado, por isso a consulta considera um período maior que o intervalo entre execuções.

**Telefone obrigatório:** mantenha a coleta de telefone habilitada no checkout para permitir a identificação dos contatos.

**Quantidade de carrinhos:** o fluxo utiliza até 50 registros por requisição. Lojas com volume superior devem considerar a implementação de paginação.

**Campos adicionais:** outros dados poderão ser incluídos na requisição conforme a documentação oficial da Nuvemshop e as necessidades da operação.

**Carrinhos repetidos:** consultas realizadas em períodos sobrepostos podem retornar os mesmos registros. Para evitar recuperações duplicadas, utilize um controle persistente baseado no ID do checkout.

**Envio pelo WhatsApp:** respeite as regras de envio da plataforma, incluindo a utilização de templates aprovados quando necessário.

* * *

## 9\. Resultado da integração

Com a integração configurada, o DataCrazy poderá consultar os carrinhos abandonados da Nuvemshop, organizar as informações retornadas e processar individualmente os clientes.

O fluxo disponibilizado oferece uma estrutura inicial para identificação e organização dos leads, permitindo que cada operação personalize suas ações de recuperação conforme a necessidade.

Antes de utilizar a automação em produção, confira as credenciais, os parâmetros da API, a identificação dos leads e as condições de envio.

* * *

## Links e/ou documentos úteis

Download do Fluxo → ⬇ [Carrinho Abandonado NuvemShop](https://drive.google.com/drive/folders/1OWXtnQIHOJ7v7IW6Pc9yI2STPjALAMxv)  
Documentação Nuvemshop → [API Nuvemshop](https://nuvemshop.dev/api/getting-started)
