Pular para o conteúdo principal

Perguntas Frequentes (FAQ)

Encontre respostas rápidas para as dúvidas mais comuns sobre botões de WhatsApp no Stevo.

Perguntas Gerais​

Os botões funcionam em todos os dispositivos?​

✅ Sim, os botões são nativos do WhatsApp e funcionam em:

  • Android (versão 2.21.0 ou superior)
  • iOS (versão 2.21.0 ou superior)
  • WhatsApp Web
  • WhatsApp Business

Os botões funcionam em grupos?​

❌ Não, atualmente os botões interativos funcionam apenas em chats privados (1 a 1). Esta é uma limitação do WhatsApp, não do Stevo.

Alternativa para grupos:

  • Envie a mensagem com botões em privado para cada membro
  • Use mensagens de texto com opções numeradas em grupos

Posso usar emojis nos botões?​

✅ Sim, você pode usar emojis em:

  • Títulos
  • Descrições
  • Texto dos botões
  • Opções de lista

Exemplo:

#bt|🍕 Cardápio|Escolha seu favorito|Bom apetite!|🍕 Pizza*pizza/🍔 Burger*burger/🌮 Taco*taco

Quantas vezes um usuário pode clicar em um botão?​

Os botões são de uso único por mensagem. Uma vez que o usuário clica:

  • O botão fica "desativado" visualmente
  • O usuário não pode mudar sua escolha
  • Você precisaria enviar uma nova mensagem com botões para outra interação

Posso editar uma mensagem com botões depois de enviada?​

❌ Não, as mensagens com botões não podem ser editadas após o envio. Se precisar mudar algo, deve:

  1. Deletar a mensagem (se ainda for possível)
  2. Enviar uma nova mensagem corrigida

Solução de Problemas​

O botão não aparece / A mensagem é enviada como texto simples​

Causas comuns:

  1. Erro de sintaxe no comando

    ❌ Incorreto: #bt|Titulo|Desc|Rodape|Opcao1*id1|Opcao2*id2
    ✅ Correto:  #bt|Titulo|Desc|Rodape|Opcao1*id1/Opcao2*id2

    Nota: Use / para separar opções, não |

  2. Espaços ou caracteres especiais

    • Não use quebras de linha no comando
    • Evite caracteres especiais como: < > { } [ ]

  3. API não configurada corretamente

    • Verifique se está usando a API correta
    • Confirme seu token de acesso

  4. Limites excedidos

    • Reply buttons: máximo 3 opções
    • List buttons: máximo 10 opções

O usuário não recebe os botões​

Verifique:

  1. Versão do WhatsApp do usuário

    • Deve ser 2.21.0 ou superior
    • Peça para atualizar o aplicativo

  2. Tipo de chat

    • É um grupo? Os botões não funcionam em grupos
    • É um broadcast? Funcionará apenas se o contato tiver você agendado

  3. Dispositivo compatível

    • Alguns dispositivos muito antigos podem ter problemas
    • Teste no WhatsApp Web

Os botões aparecem mas não respondem ao clique​

Possíveis causas:

  1. Problema temporário do WhatsApp

    • Aguarde alguns minutos
    • Reinicie o WhatsApp
    • Verifique a conexão com a internet

  2. Cache do dispositivo

    • Limpe o cache do WhatsApp
    • Reinicie o telefone

  3. Webhook não configurado

    • Se usa automatizações, verifique seu webhook
    • Confirme que seu servidor está recebendo as respostas

O botão PIX não abre o banco​

Soluções:

  1. Verifique a chave PIX

    • Está ativa no seu banco?
    • O formato está correto? (apenas números para telefone/CPF)

  2. App bancário não instalado

    • O usuário precisa ter um app de banco com PIX
    • Ofereça alternativas (QR code, código PIX)

  3. Dispositivo iOS

    • Alguns bancos no iOS requerem configuração adicional
    • Teste com outro método de pagamento

O botão de chamada não funciona​

Verifique:

  1. Formato do número

    ❌ Incorreto: +55 (11) 96571-3000
    ✅ Correto:  5511965713000
    • Sem espaços, parênteses ou traços
    • Incluir código de país

  2. Permissões do telefone

    • O usuário deve ter permissões de ligação habilitadas
    • Verifique se não está em modo avião

O botão URL não redireciona​

Problemas comuns:

  1. URL sem protocolo

    ❌ Incorreto: www.google.com
    ✅ Correto:  https://www.google.com

  2. URL inválida ou fora do ar

    • Verifique se o site está online
    • Teste a URL no navegador primeiro

  3. Firewall ou restrições

    • Alguns países/redes bloqueiam certos sites
    • Verifique se a URL é acessível

Melhores Práticas​

Validação antes de enviar​

Sempre valide seus comandos antes de enviar em produção.

Testing​

Antes de usar em produção:

  1. Teste em um chat de teste
  2. Verifique em diferentes dispositivos
  3. Confirme que o webhook funciona
  4. Teste todos os caminhos possíveis
  5. Verifique as respostas do sistema

Tratamento de erros​

Sempre tenha um plano B:

Mensagem com botão: [Enviada]

Após 2 minutos sem resposta:
"Teve problemas com os botões? 
Você pode responder com:
1 - Opção A
2 - Opção B
3 - Opção C"

Suporte​

Ainda tem problemas?​

  1. Revise a documentação oficial:

  2. Comunidade:

    • Grupo do WhatsApp de usuários Stevo
    • Canal do Telegram

  3. Suporte direto:

Tips Pro​

Performance​

  • Faça cache de comandos comuns (não regenere toda vez)
  • Use templates para comandos repetitivos
  • Pré-valide antes de enviar para a API

Monitoramento​

  • Registre quais botões têm mais cliques
  • Meça tempo de resposta dos usuários
  • Identifique botões que causam confusão

UX​

  • Mantenha consistência no estilo
  • Use emojis para melhorar legibilidade
  • Textos curtos e claros
  • Sempre ofereça "saída" (cancelar, voltar)

Checklist de Implementação​

Antes de colocar em produção:

  • Comandos validados e testados
  • Webhook configurado e funcionando
  • Plano B para erros implementado
  • Rate limiting configurado
  • Monitoramento ativo
  • Documentação interna criada
  • Equipe capacitada
  • Testes com usuários reais realizados

Encontrou um erro na documentação ou tem uma sugestão? Entre em contato! 💬