WordPress
Enviar mensagem no WhatsApp quando alguém preenche um formulário do seu site.
Quando um visitante envia um formulário no seu site WordPress, a SM Click dispara uma mensagem pelo WhatsApp — para você, para ele, ou para os dois.
Apesar do nome, a integração não depende do WordPress: ela recebe um webhook com um JSON. Qualquer formulário ou sistema capaz de fazer uma chamada HTTP funciona aqui.
O que é o WordPress
O WordPress é uma das ferramentas mais usadas para criar sites. Os formulários dele, como os de contato, geram um aviso a cada envio.
Para que serve a integração
Quando alguém preenche um formulário do seu site, a SM Click envia uma mensagem no WhatsApp: para você, para quem preencheu, ou para os dois. Nenhum contato fica sem resposta.
Requisitos
Uma instância ativa na SM Click. Ela está disponível no plano Gamma ou pode ser adquirida separadamente no gerenciamento da assinatura.
Um formulário no WordPress criado com o Elementor ou qualquer outro plugin compatível com webhooks.
Passo 1 — Criar a integração na SM Click
No menu Integrações → Nativas, clique em Webhooks com a logo do WordPress.
Escolha um nome e preencha:
| Campo | O que é |
|---|---|
| Campo de Telefone | O nome do campo que carrega o telefone dentro do JSON do formulário |
| Instância que enviará as mensagens | A instância conectada que vai disparar |
| ID do Template | Só para instância da API Oficial. Deixe vazio nas demais |
Para preencher Instância que enviará as mensagens, acesse a Home da SM Click, localize a instância, clique em Copiar token e cole o valor nesse campo.
Depois monte as regras — o texto ou o arquivo que será enviado. Clique em Salvar Integração.
Passo 2 — Copiar a URL
A SM Click gera uma URL só dessa integração. É ela que o formulário vai chamar.
Quem tiver o endereço consegue disparar a integração. Não publique em página pública, em repositório nem em grupo de WhatsApp.
Passo 3 — Configurar o formulário
No formulário do WordPress, defina os campos.
O campo de telefone é obrigatório — sem ele não há para quem enviar.
Cole a URL da SM Click no webhook do formulário.
No Elementor, a configuração fica nas ações após o envio.
O campo do telefone precisa bater
O que você escreveu em Campo de Telefone é procurado dentro do JSON que o formulário
manda. Se no WordPress o campo se chama Telefone, é Telefone que deve constar aqui —
com a mesma grafia, maiúsculas incluídas.
Quando o valor está aninhado, use o caminho separado por ponto. Num JSON assim:
{
"form": {
"fields": {
"telefone": "11999999999"
}
}
}
o campo a informar é form.fields.telefone. Índice de lista também vale:
fields[0].value.
Nome diferente entre os dois lados gera o erro “Campo do Telefone informado na integração não existe no Payload enviado pelo Webhook do Wordpress” no relatório — e nenhuma mensagem sai.
Se não souber o nome exato, envie o formulário uma vez e olhe o Payload no relatório: ele mostra o JSON como chegou. Aí você copia o nome certo.
Usar os dados do formulário na mensagem
Dentro do texto da mensagem, qualquer campo do formulário pode entrar entre chaves. Se o
JSON tem nome, escrever:
Olá {nome}, recebemos seu contato e já estamos analisando.
manda a mensagem com o nome preenchido. Vale o mesmo caminho com ponto dos campos
aninhados: {form.fields.nome}.
Campo que não existir no JSON é substituído por None no texto — outro motivo para
conferir o Payload antes de publicar o formulário.
Texto ou arquivo
Cada regra é de um dos dois tipos:
Texto — a mensagem, com ou sem variáveis.
Arquivo — imagem, áudio ou documento. A plataforma reconhece o tipo e envia da forma correspondente: imagem como imagem, áudio como mensagem de voz, o resto como anexo.
Dá para ter várias regras na mesma integração. Elas são executadas na ordem, e o relatório mostra o resultado de cada uma separadamente.
Envio por API Oficial
Na API Oficial não se envia texto livre para quem não falou com você antes — é preciso um template aprovado.
Preencha o ID do Template na integração. As variáveis do template são preenchidas
pelo nome: uma variável chamada nome recebe o campo nome do formulário; uma chamada
form.fields.email recebe o campo aninhado correspondente. Variável sem campo equivalente
chega vazia.
Há um nome com tratamento especial: variável chamada mensagem (ou message) recebe o
texto da primeira regra da integração, já com as chaves substituídas. É o jeito de usar um
template genérico e variar o conteúdo pela integração.
Sem o ID do template preenchido, a integração cai no envio de texto comum — que na API Oficial só funciona dentro da janela de 24 horas, ou seja, para quem já falou com você recentemente. Para contato novo vindo de formulário, o template é o caminho.
Quando o envio for realizado por template, não preencha o campo Mensagem, pois o conteúdo já está configurado no template.
Acompanhando
Os relatórios da integração mostram cada disparo.
Em Payload está o JSON exatamente como o formulário mandou.
Em Resultado, a mensagem montada e o status de cada envio.
Quando não sai mensagem
O relatório registra o motivo. Os que aparecem:
| O que o relatório diz | O que fazer |
|---|---|
| Integração desabilitada | Ative a integração na tela dela |
| Sem dias de uso | A assinatura não está cobrindo o uso → Financeiro |
| Instância desconectada | Reconecte o canal → Instância desconectada |
| Campo do Telefone não existe no Payload | O nome do campo não bate. Confira no Payload |
| Não foi possível validar o número informado | O valor não é um telefone válido. Coloque máscara ou validação no formulário |
| Template não encontrado | O ID do template está errado ou o template foi apagado |
| Tipo de configuração inválido | A regra não é texto nem arquivo. Recadastre |
Se não aparece nenhum registro no relatório, o formulário não chegou a chamar a URL — o problema está do lado do WordPress, não da SM Click.
Testando
Envie o formulário uma vez e confira o relatório. Esse teste vale mais que reler a configuração: ele mostra o JSON real, e é o JSON real que decide se o campo bate.
Formulário preenchido é a pessoa com maior interesse que você vai ter no dia. Uma mensagem automática confirmando o recebimento, disparada em segundos, muda bastante a taxa de resposta — mesmo que o atendimento humano venha depois.
Relacionado
ActiveCampaign
Mesmo modelo de webhook, outro sistema.
Como funcionam as integrações
O que é comum a todas.
Atualizado em