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.
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.
Após criar o aplicativo, identifique as seguintes informações:
Informação | Finalidade |
|---|---|
ID da loja | Identificar a loja nas requisições da API |
Token de acesso | Autorizar a consulta aos dados da Nuvemshop |
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.
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.
O fluxo de automação está disponível para download: ⬇ Carrinho Abandonado NuvemShop
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.
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.
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.
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.
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.
Método: GET
Endpoint:
<https://api.nuvemshop.com.br/2025-03/{id_loja}/checkouts>
Substitua {id_loja} pelo ID da loja obtido durante a criação do aplicativo.
Na seção Cabeçalho, configure:
Chave | Valor |
|---|---|
|
|
|
|
Substitua os valores de exemplo pelas informações do aplicativo criado na Nuvemshop.
Na seção Parâmetros, utilize:
Parâmetro | Valor | Finalidade |
|---|---|---|
|
| Filtrar os carrinhos pela data de criação |
|
| Definir a quantidade máxima de carrinhos retornados |
| Campos específicos | Limitar as informações retornadas |
No parâmetro created_at_min, selecione a variável dataMinima disponibilizada pelo primeiro JavaScript.
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:
id,contact_name,contact_phone,abandoned_checkout_url
Campo | Finalidade |
|---|---|
| Identificar individualmente o carrinho abandonado |
| Obter o nome do cliente |
| Obter o telefone para identificar o lead |
| Obter o link para retomar a compra |
Essa configuração reduz o tamanho da resposta e facilita a utilização das informações nos próximos blocos da automação.
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 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.
per_pageO 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.
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.
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.
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:
{
"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.
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.
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.
Após o Loop, a automação utiliza o telefone de cada carrinho para identificar o cliente correspondente no DataCrazy.
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.
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.
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.
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.
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.
Download do Fluxo → ⬇ Carrinho Abandonado NuvemShop
Documentação Nuvemshop → API Nuvemshop