Verificação de Login e Cadastro no WordPress por WhatsApp: Configuração Passo a Passo

Se o seu site WordPress tem contas de usuários, telefones falsos ou digitados errado acabam se tornando um problema, mais cedo ou mais tarde. O plugin WapFlow OTP verifica os números de telefone com um código enviado pelo WhatsApp: no formulário de cadastro, no checkout do WooCommerce, na tela de login e na redefinição de senha. Você não precisa escrever nenhum código. Neste guia, explicamos a instalação, o que cada configuração faz e o que fazer antes de colocar o site no ar.
O Que Você Precisa Antes de Começar
- WordPress 6.0 ou superior e PHP 7.4 ou superior. Para os recursos de loja, WooCommerce 7.0 ou superior.
- Uma assinatura do WapFlow OTP e pelo menos um número de WhatsApp conectado. Os códigos são enviados a partir do seu próprio número.
- Uma chave de API criada no painel do WapFlow. Sugerimos testar primeiro com uma chave de teste (
wfo_test_).
Observação: o WapFlow OTP não é a API oficial do WhatsApp Business. Ele funciona por meio de dispositivo vinculado e não garante a entrega; por isso, em ações importantes, mantenha um segundo caminho, como e-mail ou SMS.
Passo 1: Conecte o Número e Crie uma Chave
No painel do WapFlow, abra a página do WapFlow OTP. Conecte o seu número de WhatsApp com um QR code ou um código de pareamento. Em seguida, na seção de chaves de API, crie uma chave de teste e uma chave ativa. A chave é exibida apenas uma vez, no momento da criação; guarde-a em um lugar seguro.
Passo 2: Instale o Plugin
- Baixe o arquivo zip do plugin na página do WapFlow OTP ou na seção WapFlow OTP do seu painel.
- No painel administrativo do WordPress, vá em Plugins, Adicionar novo, Enviar plugin e escolha o arquivo zip.
- Quando o envio terminar, clique em "Ativar".
Passo 3: Insira a Chave e Teste a Conexão
Abra Configurações, WapFlow OTP. Cole a sua chave de teste no campo "Chave de API" e salve. Depois, clique em "Testar conexão". Se funcionar, você verá o seu plano, os códigos usados neste período e os números de WhatsApp conectados. Se nenhum número estiver conectado, o plugin mostra um aviso. A chave fica guardada no seu servidor como uma opção separada, aparece mascarada na tela de configurações (wfo_live_...1234) e nunca é enviada ao navegador dos visitantes.
Passo 4: Escolha Onde a Verificação É Obrigatória
O plugin oferece verificação em quatro lugares; ative os que você precisa:
| Área | O que faz? |
|---|---|
| Formulário de cadastro do WordPress | Adiciona um campo de telefone; o cadastro não é concluído até que o telefone seja verificado. O número é salvo no usuário. |
| Checkout do WooCommerce | Verifica o telefone de cobrança antes de o pedido ser feito. Funciona no checkout clássico e no Checkout Block. |
| Formulário de cadastro em Minha conta do WooCommerce | Aplica a mesma verificação aos cadastros na loja. |
| Login e redefinição de senha | Login com telefone mais código do WhatsApp, e redefinição de senha com código do WhatsApp. |
No checkout do WooCommerce, a configuração "Quem deve verificar" permite escolher todos, somente visitantes ou somente novos clientes. A caixa "Somente em pedidos com pagamento na entrega" é a configuração mais eficaz contra pedidos COD falsos; tratamos disso no nosso guia de pagamento na entrega.
Passo 5: Configure o Login com WhatsApp
Se você ativar "Permitir login com telefone + código do WhatsApp", pode colocar o shortcode [wapflow_otp_login] em qualquer página para criar um formulário de login sem senha. Opcionalmente, também é adicionado um botão "Entrar com WhatsApp" na página wp-login.php e no formulário de login do WooCommerce. Três regras de segurança são importantes aqui:
- Somente contas cujo telefone foi verificado por meio deste plugin podem entrar dessa forma.
- As mensagens de erro nunca revelam se um número está cadastrado.
- Os administradores ficam excluídos por padrão. Recomendamos manter assim, para que um número de WhatsApp sequestrado nunca seja suficiente para assumir o controle do site.
Recomenda-se a opção "Não permitir o uso do mesmo número de telefone em mais de uma conta"; para que o login por telefone funcione com segurança, cada número verificado deve pertencer a uma única conta. Se a redefinição de senha estiver ativada, o usuário digita o número salvo na sua conta, informa o código que chega pelo WhatsApp e, em seguida, abre-se a tela "escolher uma nova senha" do próprio WordPress.
Passo 6: Ajuste a Mensagem e o Código
- Nome exibido na mensagem: por padrão, o título do seu site.
- Idioma da mensagem: automático (idioma do site) ou um idioma que você escolher.
- Tamanho do código: de 4 a 8 dígitos.
- Validade do código: de 60 a 900 segundos.
- Código de país padrão: usado para números digitados sem código de país; 90 para a Turquia.
Passo 7: Teste com a Chave de Teste e Depois Vá para o Ambiente Real
Uma chave de teste não envia mensagem no WhatsApp e não consome cota. O código é mostrado apenas aos administradores (na caixa de verificação e no console do navegador), então você pode testar todo o fluxo com segurança. Teste, em sequência, o cadastro, o checkout, o login e a redefinição de senha. Se tudo funcionar, insira a chave ativa. Lembre-se: se você abrir a loja para os clientes antes de trocar para a chave ativa, ninguém vai receber código.
Problemas Comuns
- Aviso "O formato da chave de API não é válido": a chave deve começar com
wfo_live_ouwfo_test_; ao copiar, confirme que não entrou nenhum espaço no início ou no fim. - "Nenhum número de WhatsApp está conectado": conecte o seu número no painel do WapFlow e confirme que ele está ativo.
- "Assinatura expirada" ou mensagem de cota: renove a assinatura ou faça upgrade do plano. Quando a cota mensal se esgota, não é possível enviar novos códigos.
- A caixa de verificação não aparece no Checkout Block: confirme que o campo de telefone está ativado no formulário de pagamento. A caixa é adicionada à página com JavaScript; se um tema ou outro plugin alterar muito a estrutura da página, a posição pode precisar de ajuste.
- O cliente diz "o código não chega": ele pode não ter WhatsApp ou pode ter digitado o número errado. Deixe os seus dados de contato em um lugar visível para esses casos.
Notas de Segurança e Privacidade
- A decisão de verificação é tomada pelo servidor, e não pelo navegador. O telefone verificado fica guardado em um registro de curta duração e de uso único.
- O plugin aplica limites locais de uso de 10 envios a cada 10 minutos por IP e de 1 por minuto e 5 por hora por telefone. Os limites do próprio serviço WapFlow valem além desses. Em formulários públicos de cadastro, você pode conectar o seu plugin de CAPTCHA ao filtro
wapflow_otp_before_send. - No seu site, o plugin guarda o estado de verificação de curta duração, um cookie
wapflow_otp_sidque dura duas horas e o número verificado no perfil do usuário. Mencione a verificação por telefone na sua política de privacidade. - Para o WapFlow, são enviados somente o número de telefone, o código e os detalhes da requisição; seu nome, e-mail, pedidos e senhas não são enviados.
- Para reduzir o risco de banimento do número de envio, leia sobre aquecimento de conta e limites diários antes de começar a enviar.
Perguntas Frequentes
Meus membros atuais podem entrar com o WhatsApp?
Somente aqueles cujo número de telefone foi verificado por meio do plugin. Se o número de um membro atual for verificado, por exemplo durante um checkout verificado com ele logado, essa conta também poderá usar o método.
E se o código não chegar?
O usuário pode pedir o código novamente após a contagem regressiva de 60 segundos. Se o problema continuar, o número pode não ter WhatsApp, ou o seu número conectado pode estar offline. Verifique a conexão no painel.
O plugin está disponível em turco?
Sim. Uma tradução para o turco vem junto com o plugin, e o plugin é totalmente traduzível.
Posso usar mais de um número ao mesmo tempo?
Sim, até o número de contas do seu plano. Os envios são distribuídos entre os números em sequência; se um não conseguir enviar, o próximo é tentado. Veja os planos na página de preços.
E se eu quiser usar a API por conta própria?
O plugin é apenas para WordPress. Para o seu próprio aplicativo, consulte o guia de integração da API e a documentação da API.


