# Como integrar Nuvemshop com WhatsApp

> Com o umClique, cada evento da Nuvemshop vira uma mensagem automática no WhatsApp: pagamento aprovado, pedido criado, pagamento pendente e pagamento pendente – boleto e mais 9 eventos. A Nuvemshop é uma das maiores plataformas de loja virtual da América Latina, usada por pequenas e médias marcas no Brasil para vender com Pix, boleto e cartão.

- Página: https://connect.umcliquedigital.com/integracoes/nuvemshop-whatsapp
- Categoria: E-commerce
- Conexão: webhook (sem programar, cerca de 10 minutos)
- Atualizado em: 2026-11-02

## O que a integração faz

Na Nuvemshop o cliente gera Pix ou boleto e muitas vezes não paga, e depois quer saber quando o pedido foi embalado e enviado. A integração conecta esses eventos ao WhatsApp e ainda traz o carrinho abandonado com o link de volta ao checkout.

- Lembrete de Pix em Pagamento pendente – Pix, depois de uma breve espera
- Envio do link e da linha digitável em Pagamento pendente – Boleto
- Confirmação em Pagamento aprovado
- Aviso em Pedido embalado e Pedido enviado, com rastreio
- Recuperação de carrinho abandonado com link_carrinho
- Aviso em Pedido cancelado ou Pagamento estornado

## Eventos da Nuvemshop reconhecidos (13)

- **Pagamento aprovado**: O pagamento foi confirmado. É o evento mais usado. Data do pagamento: {{data_compra_formatado}} (28/10/2026), {{data_e_hora_compra_formatado}} (28/10/2026 16:51, horário de Brasília) e {{data_e_hora_compra_original}} (como a Nuvemshop manda).
- **Pedido criado**: O pedido acabou de ser feito, antes de qualquer pagamento.
- **Pagamento pendente**: Pedido criado aguardando pagamento (Pix ou boleto). Não use junto com os eventos de Pix e de boleto separados: o pedido dispara só um deles.
- **Pagamento pendente – Boleto**: Boleto emitido e ainda não pago. Variáveis: {{boleto_url}}, {{boleto_linha_digitavel}}, {{boleto_vencimento}}.
- **Pagamento pendente – Pix**: Pix gerado e ainda não pago. A maioria paga em até 2 minutos: comece o fluxo com uma espera antes de cobrar. Variáveis: {{pix_copia_e_cola}}, {{pix_qrcode_url}}, {{pix_validade}}.
- **Carrinho abandonado**: O cliente montou o carrinho, chegou ao checkout e não concluiu a compra.
- **Pedido enviado**: Saiu para entrega. É onde o código de rastreio costuma existir.
- **Pagamento estornado**: O pagamento foi anulado ou estornado.
- **Pedido cancelado**: O pedido foi cancelado.
- **Pedido embalado**: O pedido foi separado e embalado.
- **Pedido atualizado**: Qualquer alteração no pedido. Dispara com muita frequência — use só se souber que precisa.
- **Campos personalizados**: Um campo personalizado do pedido mudou.
- **Pedido editado**: Itens ou valores do pedido foram alterados.

## CRM para Nuvemshop: funil de vendas no WhatsApp

Cada evento da Nuvemshop pode mover o contato no kanban do umClique, criar um negócio no funil de vendas e aplicar etiquetas. Etapas sugeridas:

- **Carrinho abandonado** (Começou a comprar e saiu sem pagar.): Carrinho abandonado
- **Aguardando pagamento** (Gerou Pix ou boleto e ainda não pagou.): Pagamento pendente, Pagamento pendente – Boleto, Pagamento pendente – Pix
- **Cliente** (Pagamento aprovado.): Pagamento aprovado, Pedido criado
- **Pedido a caminho** (Pedido enviado ou em entrega.): Pedido enviado
- **Atenção** (Recusa, reembolso, cancelamento ou chargeback.): Pagamento estornado, Pedido cancelado

- Carrinhos abandonados viram uma fila de recuperação: o time vê quem desistiu e o fluxo manda a primeira mensagem na hora.
- Quem gerou Pix ou boleto fica na coluna "Aguardando pagamento" e recebe o lembrete; quando paga, o evento de compra tira o contato dali sozinho.
- Clientes que pagaram ganham etiqueta e entram em listas de pós-venda, recompra e upsell para os próximos disparos.
- O status de entrega aparece no CRM, então o atendimento responde "cadê meu pedido?" sem abrir outra ferramenta.
- Recusas, reembolsos e chargebacks ficam visíveis para o time agir rápido e salvar a venda.
- Toda a conversa, as etiquetas e o histórico de compras ficam no mesmo lugar, com vários atendentes no mesmo número.

## Passo a passo

1. **Crie a integração no umClique**: No umClique, abra Integrações e clique em Nova integração Escolha Nuvemshop na lista de plataformas Copie a URL da integração: é para ela que a Nuvemshop vai enviar os eventos
2. **Cadastre o webhook na Nuvemshop**: Nas configurações da Nuvemshop, procure a área de Webhooks, Postback ou Notificações Cole a URL da integração e escolha os eventos que você quer receber Salve e, se houver, use o botão de teste
3. **Crie a automação de cada evento**: Em Integrações, escolha o evento (por exemplo, compra aprovada) e o fluxo que ele deve iniciar Escreva a mensagem usando as variáveis, como {{nome}} Faça um evento de teste e confira a mensagem chegando no WhatsApp

Dica: Na Nuvemshop não há URL para copiar: você conecta a loja em Apps > Nuvemshop no umClique e os eventos chegam pelo app. O carrinho abandonado é consultado pela integração a cada 5 minutos e, por padrão, a mensagem sai 30 minutos após o último movimento no checkout.

## Exemplos de mensagens

- Pagamento aprovado: "Oi, {{nome}}! 🎉 Seu pagamento de {{produto}} foi aprovado. Se tiver qualquer dúvida, é só responder esta mensagem."
- Pagamento pendente: "Oi, {{nome}}! Seu pagamento de {{valor}} de {{produto}} ainda está pendente. Quer que eu te mande o código de novo?"
- Carrinho abandonado: "Oi, {{nome}}! Vi que você não finalizou a compra de {{produto}}. Ficou alguma dúvida? Posso te ajudar por aqui."

## Variáveis

`{{nome}}`, `{{telefone}}`, `{{email}}`, `{{produto}}`, `{{valor}}`, `{{pedido_numero}}`, `{{pedido_id}}`, `{{pedido_status}}`, `{{pagamento_status}}`, `{{envio_status}}`, `{{total}}`, `{{subtotal}}`, `{{desconto}}`, `{{frete}}`, `{{moeda}}`, `{{forma_pagamento}}`, `{{parcelas}}`, `{{gateway}}`, `{{cupom}}`, `{{produtos}}`, `{{produtos_qtd}}`, `{{rastreio_codigo}}`, `{{rastreio_url}}`, `{{envio_metodo}}`, `{{endereco_rua}}`, `{{endereco_numero}}`, `{{endereco_bairro}}`, `{{endereco_cidade}}`, `{{endereco_estado}}`, `{{endereco_cep}}`, `{{cpf_cnpj}}`, `{{observacao}}`, `{{data_pedido}}`, `{{loja}}`, `{{link_pagamento}}`, `{{primeiro_produto_nome}}`, `{{segundo_produto_nome}}`, `{{terceiro_produto_nome}}`, `{{quarto_produto_nome}}`, `{{quinto_produto_nome}}`, `{{primeiro_produto_preco}}`, `{{segundo_produto_preco}}`, `{{terceiro_produto_preco}}`, `{{quarto_produto_preco}}`, `{{quinto_produto_preco}}`, `{{lista_produto_separado_por_virgula}}`, `{{forma_pagamento_nome}}`, `{{link_pedido}}`, `{{pix_copia_e_cola}}`, `{{pix_qrcode_url}}`, `{{pix_validade}}`, `{{boleto_url}}`, `{{boleto_linha_digitavel}}`, `{{boleto_vencimento}}`, `{{data_e_hora_compra_original}}`, `{{data_compra_formatado}}`, `{{data_e_hora_compra_formatado}}`, `{{link_carrinho}}`, `{{data_carrinho}}`, `{{cidade}}`, `{{estado}}`, `{{cep}}`, `{{sufixo_carrinho}}`, `{{token_carrinho}}`

## Perguntas frequentes

**A Nuvemshop manda o boleto pelo WhatsApp?**
Sim. O evento Pagamento pendente – Boleto traz o link e a linha digitável do boleto para usar na mensagem.

**Como funciona o carrinho abandonado da Nuvemshop?**
A integração consulta a loja periodicamente e traz os carrinhos novos com o link de volta ao checkout, sem configurar URL.

**Por que o cliente recebeu várias mensagens do mesmo pedido?**
Uma compra gera vários eventos em sequência (criado, pendente, pago). Evite ativar todos no mesmo fluxo e comece por Pagamento aprovado e Pedido enviado.

**Posso usar Pagamento pendente junto com os eventos de Pix e boleto?**
Não é recomendado: o evento genérico se sobrepõe aos específicos de Pix e de boleto.

**Preciso saber programar para integrar a Nuvemshop com o WhatsApp?**
Não. Você cria a integração no umClique, copia a URL gerada e cola nas configurações de webhook da Nuvemshop. A partir daí, cada evento chega sozinho e dispara a mensagem que você configurou.

**Quais eventos da Nuvemshop podem disparar mensagens no WhatsApp?**
Hoje o umClique reconhece 13 eventos da Nuvemshop, entre eles Pagamento aprovado, Pedido criado, Pagamento pendente, Pagamento pendente – Boleto, Pagamento pendente – Pix e Carrinho abandonado. Você escolhe quais vão disparar mensagem.

**Posso mandar uma mensagem diferente para cada evento?**
Sim. Cada evento pode iniciar um fluxo próprio, com textos, esperas e condições diferentes, e também mover o contato no CRM ou aplicar etiquetas.

**As mensagens usam o nome do cliente e os dados da compra?**
Sim. Os dados que chegam da Nuvemshop viram variáveis, como {{nome}}, {{telefone}}, {{email}}, {{produto}} e {{valor}}, e entram no texto da mensagem automaticamente.

**Dá para usar um CRM com a Nuvemshop?**
Sim. Com o umClique, cada evento da Nuvemshop pode mover o cliente para uma etapa do kanban, criar um negócio com o valor da compra no funil de vendas e aplicar etiquetas, tudo junto das conversas do WhatsApp.

**Como fazer automação de WhatsApp com a Nuvemshop?**
Conecte a Nuvemshop ao umClique por webhook e escolha, para cada evento, o fluxo que ele inicia: mensagem, espera, condição, etiqueta, mudança de etapa no CRM ou transferência para um atendente ou para o agente de IA.

**Funciona com a API oficial do WhatsApp?**
Sim. As mensagens saem pelo número conectado ao umClique, inclusive pela API oficial da Meta. Na API oficial, mensagens fora da janela de 24 horas usam templates aprovados.
