[Extensão] Como vender produtos pelo bot com a extensão Smart Sales na Blip

1. Introdução

2. Funcionalidades

3. Instalação

4. Configuração do catálogo

5. Configuração da loja

6. Descontos e cupons

7. Configurações gerais

8. Uso no fluxo do Builder

9. Configuração do bloco Smart Sales

10. Condições de saída

11. Dados do carrinho no bot

12. Métricas e acompanhamento

13. Monitoramento de erros

14. Suporte

Descrição breve: Transforme o seu bot em uma vitrine de vendas: o cliente navega por um catálogo, monta o carrinho e volta para a conversa com o pedido pronto para ser confirmado.

Introdução

A Smart Sales adiciona uma experiência de vendas completa ao seu bot na Blip. O cliente começa a conversa no bot, abre um catálogo de produtos pelo navegador, escolhe os itens, monta o carrinho e retorna para a conversa com o resumo do pedido para confirmar a compra.

Por exemplo, um cliente que chega pelo WhatsApp recebe um link (ou um botão de catálogo) durante o atendimento. Ele abre a loja, filtra os produtos por categoria, adiciona itens ao carrinho, aplica um cupom e finaliza. A extensão devolve o pedido ao bot na variável de contato smartsalesOrder, e o seu fluxo segue para o pagamento ou para o atendimento humano.

Funcionalidades

• Catálogo com página inicial, página de detalhes do produto e produtos relacionados

• Cadastro de produtos manual (até 150 itens), por importação de arquivo CSV ou por integração com uma API própria

• Organização por categorias e marcas, busca por nome e variações de produto (cor, tamanho, e outras)

• Carrinho de compras com cupons e descontos automáticos ou por código

• Personalização da loja: logo, nome, cor principal, banners e injeção de HTML no cabeçalho

• Configuração da moeda (BRL, COP, MXN, USD) e da mensagem de resumo do pedido via Liquid

• Métricas de navegação e conversão, funil de vendas e acompanhamento de carrinhos por cliente

Suportada em todos os canais da plataforma Blip. No WhatsApp, a extensão envia um componente de catálogo com cabeçalho, corpo, rodapé e botão. Nos demais canais, envia o link do catálogo em uma mensagem de texto.

Instalação

1. Acesse a Smart Sales na Blip Store. Você também pode encontrá-la pesquisando por Smart Sales na Blip Store.

2. Abra a extensão e clique em Iniciar teste grátis para instalar no bot desejado. Você pode instalar em um bot de atendimento (Builder) ou no Roteador.

3. Após a instalação, abra o painel da extensão clicando em Smart Sales.

Configuração do catálogo

Acesse Catálogo > Configuração para escolher a origem dos produtos.

Há duas origens disponíveis: cadastro pela própria Smart Sales e integração com uma API própria.

Cadastro pela Smart Sales

Selecione Smart Sales para cadastrar e manter os produtos dentro da extensão. Essa origem tem limite de 150 produtos e não faz controle de estoque.

Integração via API

Selecione API v1 para conectar uma API própria que fornece os produtos. Use essa origem quando precisar manter produtos, preços ou estoque atualizados automaticamente a partir do seu sistema.

A API precisa seguir a especificação da Smart Sales e retornar campos como nome, descrição, preço original, preço atual, categoria, marca, tipo de unidade, quantidade mínima, SKU, imagens e variações.

A especificação completa está na OpenAPI da Smart Sales. O guia de implementação, com exemplo de código, também aparece na página de configuração quando você seleciona a origem por API. Esse procedimento só é necessário na primeira vez que você conecta a sua API.

Autenticação: toda requisição deve enviar o token no cabeçalho Token.

Endpoints esperados:

• GET /api/products: lista de produtos.

• POST /api/products: lista de produtos com filtro.

• GET /api/products/categories: lista de categorias.

• GET /api/products/brands: lista de marcas.

• GET /api/products/{sku}: detalhes de um produto por SKU.

• GET /api/products/relatedProducts/{sku}: produtos relacionados a um SKU.

Os endpoints de listagem aceitam os parâmetros de query identity (identifica a requisição), skip (registros a ignorar, padrão 0) e take (registros a retornar, padrão 10). Para testar a integração, use a coleção do Postman. Se você ainda não tem uma API, aponte a configuração para a API de exemplo em https://sample-api-v1.smartsales.whitewall.dev.

Cadastro de produtos

Com a origem Smart Sales selecionada, acesse Catálogo > Produtos para cadastrar os itens. Preencha nome, descrição, preço, categoria, marca, SKU, tipo de unidade, quantidade mínima e imagens. Defina variações quando o produto tiver opções como cor, tamanho, sabor, voltagem ou modelo.

Use um SKU único para cada produto, mantenha os preços atualizados e cadastre imagens com links públicos, sem repetir a mesma imagem. Confira a unidade configurada e valide os nomes e acréscimos de cada variação.

Atenção: o cadastro pela Smart Sales está limitado a 150 produtos e não faz controle de estoque. Para catálogos maiores ou com estoque, use a integração via API.

Você também pode cadastrar produtos importando um arquivo CSV, que respeita o mesmo limite de produtos.

Configuração da loja

Depois de cadastrar os produtos, acesse Loja > Tema para personalizar a aparência da loja.

Nessa tela você configura o logo, o nome da loja, a cor principal, os banners e os links dos banners. A extensão mostra uma prévia da versão móvel e permite visualizar a versão desktop.

Para um controle maior de layout, injete HTML personalizado no cabeçalho da loja.

Descontos e cupons

Acesse Descontos para criar campanhas promocionais. Cada desconto tem um nome interno e uma descrição, usados só para identificação, e um código de cupom.

O valor do desconto pode ser fixo ou em porcentagem. Você também define um valor mínimo de compra; sem esse campo, qualquer pedido pode usar o desconto. Restrinja a validade a um período pelo campo de datas e desabilite um cupom a qualquer momento pelo ícone no canto superior direito.

Se o campo de cupom ficar vazio, o desconto é aplicado automaticamente quando o cliente atende aos demais critérios.

As Condições dão controle fino sobre onde o desconto vale: você restringe por marcas, categorias ou por SKU. Pelo campo Propriedades de contato, você libera o cupom apenas para clientes cujo contato na Blip tenha os campos definidos.

A combinação funciona assim: dentro de um mesmo campo, a regra é um "ou" inclusivo (um desconto para as marcas A e B vale para as duas). Entre campos distintos, é preciso corresponder a cada um (um desconto para a marca A e a categoria Z só vale para produtos que atendem aos dois critérios). Na própria tela de Descontos você edita ou exclui os cupons existentes.

Quando existe ao menos um cupom cadastrado, o cliente ganha um campo para inserir o código durante a compra.

Atenção: cada pedido usa apenas um cupom por código, mas descontos automáticos também podem ser aplicados quando o cliente e os produtos são elegíveis.

Configurações gerais

Na página Configurações, defina a moeda da loja (BRL, COP, MXN, USD) e a mensagem de resumo enviada ao cliente quando ele conclui o carrinho.

A mensagem de resumo usa Liquid, então você monta o texto com os dados do pedido (itens, subtotal, desconto e total).

Ao receber essa mensagem, o cliente confirma o pedido, recusa, ou não responde. Depois de 24 horas sem resposta, a extensão trata o caso como inatividade. Esses três comportamentos são direcionados no seu fluxo no Builder.

Uso no fluxo do Builder

Para enviar o catálogo dentro de um fluxo, você adiciona o bloco da Smart Sales no Builder. Isso exige a extensão de navegador da Wiv para o Builder.

Instalar a extensão de navegador

Instale a extensão Better Blip Builder no Chrome e aceite as permissões.

Adicionar o bloco ao fluxo

1. Abra o Builder e atualize a página.

2. Clique em +.

3. Selecione Nova integração.

4. Escolha Smart Sales.

Se a opção não aparecer, confirme que a extensão de navegador está instalada e atualize a página. Se a Smart Sales estiver instalada no Roteador, habilite o contexto do roteador no Builder.

Configuração do bloco Smart Sales

No bloco de integração, ajuste a mensagem que o cliente recebe ao iniciar a compra. A configuração dos componentes é opcional: sem alterações, a extensão usa os textos padrão.

O componente do WhatsApp é mais flexível e permite definir cabeçalho, corpo, rodapé e texto do botão, além do corpo da mensagem.

Os números à direita de cada campo indicam quantos caracteres ainda cabem.

Nos demais canais, a mensagem é um texto simples com o link do catálogo.

Defina um nome para a variável de resultado. Use um nome descritivo, como resultSmartsales. Ela alimenta as condições de saída na próxima etapa. Salve o bloco.

Atenção: o componente rico do WhatsApp não é enviado no WhatsApp Web.

Condições de saída

Use a variável de resultado para direcionar o fluxo. Os valores possíveis são:

• ACCEPT_TO_BUY: o cliente confirmou a compra.

• REFUSED_TO_BUY: o cliente recusou a compra.

• INACTIVITY: o cliente não respondeu em 24 horas e o carrinho foi abandonado.

Além desses valores, você configura outras condições de saída no bloco, como em qualquer outro bloco do Builder.

Dados do carrinho no bot

Ao encerrar a seleção dos produtos, a extensão envia todas as informações do carrinho para o bot e salva o pedido na variável de contato smartsalesOrder, que você lê por contact.extras.smartsalesOrder.

A finalização do pagamento e o registro do pedido ficam por conta da sua operação, seja por atendimento humano no Blip Desk, seja por um sistema automatizado. Essa etapa ainda não é integrada pela Smart Sales, então configure-a no seu fluxo.

Métricas e acompanhamento

O painel da extensão reúne indicadores de vendas: valor total dos pedidos, taxa de conversão, carrinhos enviados, em aberto e abandonados, produtos mais clicados e mais comprados, termos mais pesquisados e estados e países com mais acessos. Em Analytics > Carrinhos, você acompanha o carrinho de cada cliente; em Analytics > Insights, analisa o funil de vendas.

Monitoramento de erros

Para receber alertas de falhas na Smart Sales, use a extensão de monitoramento da Blip:

1. Acesse o Roteador ao qual a Smart Sales pertence e instale a extensão Logs e monitoramento de erros pela Blip Store.

2. No painel dela, clique em Gerenciar alertas.

3. Informe os e-mails que devem receber os alertas e ative Habilitar alertas baseados em eventos.

4. Adicione os eventos Smart Sales Internal Error e Smart Sales Error ao monitoramento.

Suporte

Em caso de dúvidas ou problemas com a extensão, fale com a gente pelo e-mail support@wiv.com.br.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃