Como Enviar Botões no WhatsApp Normal Usando Z-API (Passo a Passo)

Este artigo foi pensado a partir do vídeo acima. A ideia é que você consiga, de um jeito direto, entender como enviar botões no WhatsApp normal usando a Z-API, tendo um passo a passo claro, leve e aplicável. Mas, sinceramente, além do “como fazer”, eu quero mostrar porque soluções de automação, integração e comunicação centralizada, como as que a Clique Digital oferece, mudam a rotina de pequenos negócios, e-commerce, clínicas e times enxutos. Sentiu algum desafio com atendimento ou vendas pelo WhatsApp? Então este conteúdo pode fazer diferença, de verdade.

Por que enviar botões no WhatsApp é tão valioso para empresas

Vamos conversar um pouco sobre comportamento. O brasileiro passa horas por dia no WhatsApp. Ele compra, tira dúvidas, agenda consultas e decide o que consumir direto ali.

Automação abre caminho para vender mais e atender melhor, sem dor de cabeça.

Segundo dados compartilhados pela Zendesk, 76% dos brasileiros já conversam com empresas pelo WhatsApp, e mais da metade já fecharam compras só pelo app. Então, por que não usar tudo o que a plataforma oferece, inclusive os botões, para criar experiências mais rápidas e práticas para quem está do outro lado?

Os botões permitem ao cliente agir sem digitar. Com um toque, ele compra, pede orçamento, confirma horários ou vai para o pagamento. Isso diminui barreiras, acelera decisões e deixa tudo mais fluido.

Entendendo o que são botões no WhatsApp e como a Z-API viabiliza tudo

A primeira confusão que aparece é: botão só funciona no WhatsApp Business API? Felizmente, a Z-API permite enviar botões até para WhatsApp normal, inclusive em nomes individuais e grupos, seja no app mobile ou no WhatsApp Web, para contas comuns ou comerciais (https://developer.z-api.io/tips/button-status). Isso amplia bastante o alcance.

A documentação da Z-API traz detalhes sobre dois métodos principais para envio de botões:

• /send-button-actions: envia mensagens com botões personalizados de ação — ligações, links, respostas rápidas (Quick Reply).
• /send-button-pix: para mandas mensagens com botões de pagamento PIX direto no chat (https://developer.z-api.io/message/send-button-pix).

Cada botão pode ser ajustado de acordo com o objetivo. Por exemplo:

• Um botão “Falar com um consultor” dispara uma ligação automaticamente.
• Um “Visitar site” direciona o cliente para uma página externa.
• O “Copiar chave PIX” facilita pagamentos.

As possibilidades são diversas, mas é preciso entender as limitações para garantir uma experiência boa, sem erros no WhatsApp Web. Existe um cuidado especial na escolha e quantidade de botões por mensagem, conforme recomendações da própria Z-API.

Os tipos de botões possíveis e suas limitações

Segundo a documentação oficial da Z-API, há três principais tipos de botões:

• CALL: botão que faz ligações diretas.
• URL: botão que leva para um link externo.
• REPLY: resposta rápida configurada.

É bom saber que, ao tentar misturar todos os tipos em uma mesma mensagem, o WhatsApp Web pode não aceitar bem. O recomendado: use CALL e URL juntos e, se preferir, mantenha os botões REPLY em mensagem separada. O objetivo aqui é evitar incompatibilidades, travamentos ou falhas na experiência do usuário (https://developer.z-api.io/tips/button-status).

Em relação à quantidade, a Huggy API (concorrente da Z-API) destaca limites: três botões para “Quick Reply”, quatro a dez como lista interativa, e mais de dez usando apenas texto corrido (https://developers.huggy.io/pt/API/api-v3.html). Mas, de modo geral, para a Z-API, três botões por mensagem mantém a compatibilidade e clareza para o cliente.

O segredo está no equilíbrio: botões demais confundem, poucos resolvem de verdade.

Por dentro do passo a passo: como enviar botões no WhatsApp normal usando a Z-API

Chegou a parte prática. É verdade, muitos tutoriais ensinam como fazer – mas muitos pulam detalhes ou sugerem caminhos complexos. Aqui, o objetivo do projeto Pablo Cabral é clarear e simplificar ao máximo, já que atendemos e acompanhamos quem está na linha de frente do negócio todos os dias. Então, vamos ao processo real:

1. ativando e configurando a Z-API

O primeiro passo é criar sua conta na Z-API. O próprio processo de cadastro é simples e requer apenas o número do WhatsApp e um e-mail válido. Após isso, você terá acesso a um painel para configuração do API Token, conexão do WhatsApp e visualização de métodos disponíveis.

• Crie seu cadastro na Z-API.
• Obtenha seu API Token (um código único para liberar acesso seguro à API).
• Faça a leitura do QR Code exibido — igual ao WhatsApp Web — para conectar sua conta.

2. entendendo as requisições

A comunicação com a Z-API é via requisição HTTP POST. Isso pode ser feito por plataformas de integração, sistemas próprios, até ferramentas como Postman, Zapier, Make (antigo Integromat) ou nativamente nos sistemas mais modernos, como o Connect da Clique Digital.

3. montando o JSON da mensagem

O segredo está no corpo da requisição. O método /send-button-actions espera um JSON com as informações:

{ "phone": "5511999998888", "message": "Bem-vindo! Escolha uma opção:", "buttonActions": [   {     "type": "CALL",     "phone": "5511222333444",     "label": "Ligar agora"   },   {     "type": "URL",     "url": "https://minhaloja.com.br/pagamento",     "label": "Finalizar compra"   },   {     "type": "REPLY",     "label": "Quero atendimento"   } ]}

Você pode personalizar conforme a necessidade, mas lembre-se dos critérios de compatibilidade entre tipos de botões.

4. validando o retorno e corrigindo erros

Após o envio da requisição, a Z-API traz uma resposta automática de sucesso ou erro. Fique atento: se tentar juntar as três opções de botão (CALL, URL e REPLY), pode receber mensagem de erro. Se isso acontecer, adapte a estrutura para seguir as recomendações da documentação para botões (https://developer.z-api.io/message/send-button-actions).

5. conferindo no WhatsApp

Se tudo deu certo, em segundos, a conversa no WhatsApp vai mostrar a mensagem com os botões. O cliente só precisa clicar na opção desejada. Você pode acompanhar tudo pelo seu celular ou mesmo usando o WhatsApp Web.

A diferença de um ecossistema completo: apresentando o Clique Digital

É curioso como boa parte dos negócios tenta montar um “frankenstein” de ferramentas: API de um lado, chat inbox do outro, planilha para controlar pedidos, WhatsApp aberto em mais de um computador…

Quando centraliza tudo, sobra tempo para pensar no crescimento, não só em resolver problemas.

Por isso, destaco o Clique Digital. É uma plataforma 100% brasileira, pensada para micro, pequenas e médias empresas que querem ter tudo num só lugar: atendimento, automações, vendas, cadastro, histórico, integração de canais, uso de API, e até recuperação de números bloqueados.

Conclusão

A integração de botões no WhatsApp, combinada com automações, centralização e uso inteligente de sistemas como o Clique Digital, tira o peso do atendimento manual e deixa o time focado no que realmente importa: construir relacionamento e fechar vendas. Apostar em ferramentas certas, alinhadas à realidade do negócio, faz diferença não só em produtividade como também na satisfação do cliente.

Não se trata só de adicionar tecnologia, mas de criar experiências mais naturais e fluidas para quem compra, agenda ou busca atendimento. E, se no meio do caminho surgir dúvida, curiosidade ou vontade de experimentar uma solução pensada para o seu porte de negócio, fico te esperando no direct do Instagram @pablocabralc. Vamos conversar sobre automação e crescimento real do seu negócio!

Perguntas frequentes

Como enviar botões no WhatsApp normal?

Para enviar botões no WhatsApp normal, utilize a Z-API, que permite o envio de mensagens interativas através do método ‘/send-button-actions’. Você só precisa configurar sua conta, criar um JSON com as informações do botão (tipo, ação e rótulo) e realizar a requisição HTTP usando seu API Token. Assim, as mensagens aparecem com botões clicáveis para o destinatário, mesmo em contas comuns.

O que é a Z-API e para que serve?

A Z-API é uma interface de programação (API) que conecta sistemas externos ao WhatsApp. Ela permite enviar mensagens automáticas, botões interativos (ações, links, respostas rápidas), imagens, arquivos e até implementar fluxos automatizados, tanto no WhatsApp Business quanto em contas comuns. Seu objetivo é facilitar automação, atendimento, vendas e integração entre canais.

Preciso pagar para usar a Z-API?

Sim, o uso completo da Z-API é pago, pois envolve infraestrutura, manutenção e suporte. Existem testes gratuitos ou créditos de demonstração, mas, para uso contínuo e estável, é necessário adquirir um dos planos disponíveis na plataforma da Z-API.

Quais tipos de botões posso enviar?

Com a Z-API, é possível enviar três tipos principais de botões: CALL (realiza ligações automáticas a partir do WhatsApp), URL (direciona para links externos), e REPLY (respostas rápidas, com frases definidas). Para pagamentos, há também botões PIX exclusivos para facilitar transações financeiras em conversas.

Existe limite de botões por mensagem?

Sim, recomenda-se enviar até três botões por mensagem para garantir que todos apareçam corretamente em diferentes versões do WhatsApp ou WhatsApp Web. O envio de muitos botões pode causar erros ou tornar a experiência confusa para o cliente. Cada API pode definir limites próprios, mas três costuma ser o padrão para melhor compatibilidade.