- Os Botões Especiais adicionam botões extras logo abaixo do botão Comprar, na página do produto. Você cria quantos quiser, cada um com seu texto, cor e ícone.
- Existem quatro tipos: comprar uma quantidade pronta (ex.: "Compre 4 pneus"), comprar agora (vai direto para o pagamento), comprar pelo WhatsApp (a mensagem já sai com o produto) e link (tabela de medidas, manual, telefone, e-mail).
- O texto do botão pode mostrar o preço da quantidade e o preço à vista, já com as promoções do produto.
- Disponível para lojas Magento 1.
Passo a Passo por Escrito
1. Acesse as configurações dos Botões Especiais
No painel administrativo, acesse Catálogo → Botões Especiais → Configurações.
Essa tela também pode ser aberta por Sistema → Configuração → Catálogo → Botões Especiais.
Resultado esperado: A tela de configuração será exibida com as seções Geral, WhatsApp e Aparência padrão.
2. Confira a seção Geral
Na seção Geral:
- Em Ativar Botões Especiais, escolha Sim. Com Não, nenhum botão aparece na loja.
- Em Bloco do botão Comprar, mantenha o valor que já vem preenchido (
product.info.addtocart). Só altere se o suporte orientar. - Em Atributo do desconto à vista (%), mantenha
porcentagem_desconto_boleto, que é o campo de desconto à vista usado nos produtos da sua loja. Ele é usado pelos preços à vista do texto do botão (ver passo 6).
O módulo vem desativado. Sem marcar Ativar Botões Especiais = Sim e clicar em Salvar, nenhum botão aparece na loja.
Resultado esperado: A seção Geral fica com o módulo ativo e os dois campos de texto preenchidos.
3. Defina o WhatsApp padrão (opcional)
Na seção WhatsApp, preencha os valores usados pelos botões de WhatsApp que não tiverem número ou mensagem próprios:
- Número padrão: com DDD. Ex.:
45999515687. - Mensagem padrão: o texto que já vem escrito na conversa. Você pode usar as variáveis abaixo.
| Variável | O que mostra |
|---|---|
{produto} |
Nome do produto |
{sku} |
Código do produto |
{qty} |
Quantidade escolhida no campo de quantidade |
{opcoes} |
Opções escolhidas (tamanho, cor…) |
{url} |
Endereço da página do produto |
A mensagem que já vem preenchida é: "Olá! Tenho interesse no produto {produto} (código {sku}), quantidade {qty}. {opcoes}", com o endereço do produto na linha de baixo.
Para números do Brasil, basta digitar o DDD e o número — o código do país é acrescentado sozinho. Para número de outro país, digite com o código do país.
Se nenhum botão de WhatsApp tiver número próprio, o Número padrão é obrigatório. Sem número, o botão de WhatsApp não pode ser salvo e não aparece na loja.
Resultado esperado: O número e a mensagem padrão ficam salvos para todos os botões de WhatsApp.
4. Defina a aparência padrão (opcional)
Na seção Aparência padrão:
- Cor do botão e Cor do texto: clique no quadrado para escolher a cor ou cole o código (ex.:
#2f4a8a). Em branco, os botões usam as cores do seu tema. - Arredondamento das bordas (px): o padrão é
6. Use0para cantos retos. Em branco, segue o arredondamento do botão Comprar do tema. - Quando a linha não completar: o que fazer com a última linha de botões quando ela não fica cheia (ex.: 4 botões de um terço — o quarto fica sozinho embaixo):
- Esticar para preencher a linha: os botões da última linha dividem o espaço todo.
- Manter o tamanho, alinhados à esquerda.
- Manter o tamanho, centralizados.
Clique em Salvar.
As cores definidas aqui valem para os botões que não têm cor própria. Cada botão pode ter a sua cor no cadastro dele.
Resultado esperado: Uma mensagem de "A configuração foi salva" será exibida no topo da tela.
5. Crie um novo botão
Acesse Catálogo → Botões Especiais → Criar/Editar Botões e clique em Adicionar Botão.
A tela do botão tem duas abas à esquerda: Botão e Produtos. Na aba Botão, os campos estão em três seções: Botão, Aparência e Onde aparece. Cada campo só aparece quando faz sentido para o tipo de botão escolhido.
Resultado esperado: A tela Novo Botão será exibida, com a aba Botão aberta.
6. Preencha os dados principais do botão
Na seção Botão:
- Nome do botão: um nome para você identificar o botão na lista. Não aparece na loja. Ex.: Jogo com 4 pneus.
- Ativo: Sim para o botão aparecer na loja.
- O que o botão faz: escolha o tipo:
- Adicionar quantidade pronta ao carrinho: coloca uma quantidade fixa no carrinho. Ex.: um jogo de 4 pneus.
- Comprar agora (vai direto ao checkout): coloca o produto no carrinho e leva o cliente direto para o pagamento.
- Comprar pelo WhatsApp: abre uma conversa no WhatsApp com o produto na mensagem.
- Link personalizado: abre uma página, um arquivo (tabela de medidas, manual), um telefone ou um e-mail.
- Quantidade: aparece nos tipos de quantidade e de comprar agora. É quantas unidades vão para o carrinho. Ex.:
4. No Comprar agora, deixe em branco para usar a quantidade que o cliente escolheu no campo. - Texto do botão: o que o cliente lê no botão. Você pode usar as variáveis abaixo.
| Variável | O que mostra |
|---|---|
{qty} |
A quantidade do botão |
{produto} |
Nome do produto |
{preco_unitario} |
Preço de uma unidade, na quantidade do botão |
{preco_total} |
Preço total da quantidade |
{preco_avista_unitario} |
Preço de uma unidade à vista |
{preco_avista_total} |
Preço total à vista |
\n |
Quebra a linha do texto |
Exemplo: Compre {qty} pneus\n{preco_total}\nou {preco_avista_total} à vista aparece em três linhas: Compre 4 pneus / R$ 1.598,00 / ou R$ 1.438,20 à vista.
Os preços já consideram o preço promocional, as regras de preço de catálogo e o preço por quantidade do produto. Para dar desconto no jogo de 4 pneus, cadastre o preço por quantidade no produto (a partir de 4 unidades) — o botão mostra o preço com o desconto.
O preço à vista desconta a porcentagem preenchida no campo de desconto à vista do produto. Se o produto não tiver essa porcentagem, o preço à vista fica igual ao preço normal.
Os preços só aparecem nos botões com Quantidade preenchida e em produtos simples. Em produtos configuráveis (com tamanho, cor…) e em kits, as variáveis de preço ficam em branco. Promoções feitas por regra de carrinho também não aparecem no botão, porque só são aplicadas no pagamento.
O preço à vista mostrado no botão é só informativo. O desconto de verdade continua vindo da regra de desconto do boleto/Pix da sua loja. Sem essa regra, o cliente não recebe o desconto no pagamento.
Resultado esperado: Os campos Nome do botão, O que o botão faz e Texto do botão ficam preenchidos (e a Quantidade, quando o tipo pede).
7. Ajuste o texto, o espaço e a ordem do botão (opcional)
Ainda na seção Botão:
- Tamanho do texto: de
12a20px. Padrão do tema mantém o tamanho dos outros botões da loja (13 px). - Estilo do texto: Normal, Negrito, Itálico ou Negrito e itálico. Normal tira o negrito que o tema coloca nos botões; Padrão do tema não muda nada.
- Espaço do botão na linha:
- Linha inteira (um por linha)
- Metade da linha (até dois lado a lado)
- Um terço da linha (até três lado a lado)
- Ordem: o botão com o menor número aparece primeiro.
Botões seguidos com o mesmo espaço ficam lado a lado. Um botão de Metade depois de um de Um terço vai para a linha de baixo. No celular, os botões ficam sempre um embaixo do outro.
O tamanho e o estilo do texto valem só para este botão e só na página do produto.
Resultado esperado: O botão fica com o tamanho de texto, o estilo, o espaço e a posição que você escolheu.
8. Configure o WhatsApp (somente para botões de WhatsApp)
Se você escolheu Comprar pelo WhatsApp, preencha:
- Número do WhatsApp: com DDD. Em branco, usa o Número padrão do passo 3. Útil para ter botões diferentes, como Vendas e Atacado.
- Mensagem: o texto da conversa, com as variáveis do passo 3. Em branco, usa a Mensagem padrão.
- Esconder o botão personalizado antigo: Sim esconde o botão de WhatsApp antigo da loja nos produtos em que este botão aparece, para o cliente não ver dois botões. Nada é apagado: volte para Não e o antigo reaparece.
- Onde o botão aparece:
- Só na página do produto
- Página do produto e listagens: o botão também aparece nos produtos da página inicial, das categorias, da busca e dos produtos relacionados.
Nas listagens, a mensagem do WhatsApp vai com quantidade 1 e sem as opções (tamanho, cor…), que só existem na página do produto.
O botão nas listagens depende do tema da loja. Ele aparece nos temas padrão da mageshop. Se não aparecer na sua loja, fale com o suporte.
Resultado esperado: O botão de WhatsApp fica com o número, a mensagem e os locais em que deve aparecer.
9. Configure o link (somente para botões de link)
Se você escolheu Link personalizado, escolha o Destino do link:
Endereço (URL) — para uma página, telefone, e-mail ou arquivo que já está na internet. Preencha o Endereço do link em um destes formatos:
| Formato | Exemplo | Para que serve |
|---|---|---|
| Outro site ou PDF | https://site.com/pagina |
Página ou arquivo na internet |
| Página da sua loja | /tabela-de-medidas |
Página desta loja |
| Parte desta página | #especificacoes |
Rola até uma seção da página do produto |
| Telefone | tel:45999515687 |
Liga para o número |
mailto:contato@loja.com.br |
Abre o e-mail |
Você pode usar {sku}, {produto} e {url} no endereço. Ex.: https://agenda.com/?produto={sku}. Em Abrir em nova aba?, escolha Sim para o cliente não sair da loja.
Arquivo enviado — para um PDF ou imagem que você envia aqui (tabela de medidas, manual):
- Em Arquivo, clique para escolher o arquivo. São aceitos PDF, JPG, PNG e WEBP, até 10 MB.
- Em Ao clicar, escolha Baixar o arquivo (vai direto para os downloads do aparelho) ou Abrir no navegador (o cliente vê o arquivo na hora).
- Com Abrir no navegador, escolha em Abrir em nova aba? se o arquivo abre em outra aba.
Endereços em outros formatos são recusados ao salvar. O erro mais comum é colar o site sem o https:// no começo.
Enviar um arquivo novo substitui o atual, e o antigo é apagado. Para tirar o arquivo, marque Remover o arquivo. Arquivos SVG e HTML não são aceitos, por segurança.
Resultado esperado: O botão fica com o endereço preenchido ou com o nome do arquivo enviado em Arquivo atual.
10. Escolha o ícone e as cores (opcional)
Na seção Aparência:
- Ícone: escolha um ícone pronto (WhatsApp, Link (seta para fora), Informação, Régua (medidas), Download, Calendário, Telefone, E-mail) ou Personalizado (enviar uma imagem). Os ícones prontos usam a cor do texto do botão.
- Imagem do ícone (só em Personalizado): envie um PNG, JPG ou WEBP de até 200 KB, quadrado (ou quase), entre 16 e 512 px. Prefira PNG ou WEBP com fundo transparente, com pelo menos 96 px.
- Tamanho do ícone: Normal (20 px), Médio (32 px), Grande (40 px) ou Extra grande (48 px). Para imagem enviada, use Médio ou maior.
- Pintar com a cor do texto do botão? (só em Personalizado): Sim usa só o formato da imagem e pinta com a cor do texto, como os ícones prontos. Não mostra a imagem como ela é (ex.: um logo colorido).
- Posição do ícone: Antes do texto ou Depois do texto.
- Cor do botão e Cor do texto: clique no quadrado ou cole o código da cor. Em branco, usa a cor padrão do passo 4 ou a do tema.
Num botão novo de WhatsApp, o ícone do WhatsApp já é escolhido sozinho. E ao escolher Personalizado, o tamanho muda sozinho para Médio.
Imagem JPG não tem fundo transparente: com Pintar em Sim, ela viraria um quadrado colorido. Por isso, para JPG o módulo sempre mostra a imagem como ela é.
Resultado esperado: A prévia do ícone enviado aparece ao lado de Ícone atual, e o botão fica com as cores escolhidas.
11. Defina em quais produtos o botão aparece
Na seção Onde aparece, preencha só o que quiser filtrar:
- Lojas: em quais lojas o botão aparece (quando a sua loja tem mais de uma).
- Só em produtos com o atributo em Sim: reaproveita uma marcação que você já faz no produto. Ex.: Exibir botão personalizado? — os produtos que já estão em Sim passam a mostrar este botão.
- Categorias: o botão aparece nos produtos dessas categorias e das subcategorias delas. Segure Ctrl e clique para marcar mais de uma. Em lojas com muitas categorias, o campo vira Categorias (IDs): digite os IDs separados por vírgula (ex.:
12, 15). - Conjuntos de atributos: o botão aparece só nos produtos desses conjuntos.
Todas as regras preenchidas precisam valer ao mesmo tempo. Ex.: categoria Pneus + atributo Exibir botão personalizado? = o botão só aparece nos pneus que estão com esse atributo em Sim. Com todas em branco, o botão aparece em todos os produtos.
Resultado esperado: As regras escolhidas ficam marcadas na seção Onde aparece.
12. Escolha produtos específicos (opcional)
Para mostrar o botão só em alguns produtos, clique na aba Produtos, à esquerda.
- Use os filtros da lista para encontrar os produtos.
- Marque a caixa de seleção de cada produto.
- Para conferir os já marcados, filtre a primeira coluna por Sim.
Nenhum produto marcado = o botão não filtra por produto. Trocar de página ou filtrar a lista não perde os produtos já marcados.
Resultado esperado: Os produtos escolhidos aparecem marcados na lista da aba Produtos.
13. Salve o botão e atualize o cache
- Clique em Salvar Botão (ou em Salvar e Continuar Editando para continuar na mesma tela).
- Atualize o cache: acesse Sistema → Cache, clique em Marcar Todos, escolha Atualizar no campo Ações e clique em Enviar.
A página do produto fica guardada em cache (memória temporária da loja). Sem atualizar o cache, a alteração não aparece para os clientes.
Na lista de botões, você também pode Duplicar um botão (a cópia nasce desativada) e ativar, desativar ou excluir vários botões de uma vez, pelas Ações acima da lista.
Resultado esperado: A mensagem "Botão salvo." será exibida, e o botão aparecerá na lista de Criar/Editar Botões.
Validação e Testes
Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.
Teste 1 — Botão de quantidade pronta
Ação: abra na loja um produto em que o botão vale, confira o texto e o preço do botão e clique nele. Depois, abra o carrinho.
Resultado esperado: O botão aparece logo abaixo do Comprar, com a quantidade e o preço no texto, e o carrinho recebe a quantidade do botão (ex.: 4 unidades).
Teste 2 — Comprar agora
Ação: num produto com o botão Comprar agora, escolha as opções (se houver) e clique no botão.
Resultado esperado: O produto vai para o carrinho e a loja abre direto a página de pagamento.
Teste 3 — Aviso de estoque
Ação: num produto com menos unidades em estoque do que a quantidade do botão (ou já com unidades no carrinho), clique no botão de quantidade.
Resultado esperado: Uma mensagem em vermelho aparece abaixo dos botões explicando o motivo (ex.: "Não temos essa quantidade deste produto em estoque no momento."), e nada é adicionado ao carrinho.
Teste 4 — WhatsApp
Ação: num produto com o botão de WhatsApp, escolha a quantidade e as opções e clique no botão. Se escolheu Página do produto e listagens, abra também uma categoria com esse produto.
Resultado esperado: O WhatsApp abre com o número cadastrado e a mensagem já com o nome, o código, a quantidade, as opções e o endereço do produto. Na categoria, o botão aparece no produto.
Teste 5 — Link ou arquivo
Ação: num produto com o botão de link, clique no botão.
Resultado esperado: A página, o telefone ou o e-mail abre, ou o arquivo é baixado/aberto conforme o que você escolheu em Ao clicar.
Teste 6 — Se algo não funcionar
Se não funcionar, verifique:
- Se Ativar Botões Especiais está em Sim e o botão está Ativo.
- Se o cache foi atualizado depois de salvar.
- Se o produto atende a todas as regras de Onde aparece (lojas, atributo, categorias, conjuntos e produtos marcados).
- Nos botões de quantidade e de comprar agora: se o botão Comprar aparece nesse produto e se o produto tem estoque para a quantidade do botão.
- No WhatsApp: se há número no botão ou no Número padrão.
Pronto! Dessa forma realizamos a configuração dos Botões Especiais em sua loja virtual Magento 1.
Observações Importantes
- Botões de compra seguem o botão Comprar: os botões de quantidade e de comprar agora só aparecem quando o botão Comprar da loja aparece. Produto esgotado ou com a compra oculta não mostra esses botões. O WhatsApp e o link aparecem mesmo assim.
- Quantidade que o produto não aceita esconde o botão: se a quantidade do botão for menor que a compra mínima, maior que a compra máxima, fora dos múltiplos do produto ou maior que o estoque, o botão não aparece nesse produto.
- Produtos configuráveis e kits: os preços no texto ficam em branco. Em produtos agrupados, os botões de quantidade e de comprar agora não aparecem.
- Listagens só com WhatsApp: nas páginas de categoria, busca e home, só o botão de WhatsApp pode aparecer, com quantidade 1. O tamanho e o estilo do texto e o tamanho do ícone valem só na página do produto.
- Celular: os botões ficam sempre um embaixo do outro.
- Botão de esgotado: em produto esgotado onde o botão de WhatsApp novo aparece com Esconder o botão personalizado antigo em Sim, o botão de produto esgotado do tema também pode ficar escondido na página do produto.
- Sem data nem grupo de cliente: não é possível programar o botão por período nem mostrá-lo só para um grupo de clientes.
- Vários botões de WhatsApp: você pode ter vários (ex.: Vendas, Atacado, Dúvidas), cada um com número, mensagem e regras próprios.
Referências e Relacionados
- Limpeza de cache da loja: toda alteração nos botões só aparece depois de atualizar o cache. Aprenda a atualizar o cache da sua loja
- Preço por quantidade do produto: é o que dá desconto no jogo/kit e aparece no preço do botão.
- Regras de preço de catálogo: promoções de catálogo também entram no preço mostrado no botão.
- Atributos de produto: para entender e criar o campo Sim/Não usado na regra Só em produtos com o atributo em Sim.
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br