 Widget de Pesquisas

Com o widget de pesquisas, é possível coletar dados para a posterior criação automática de arquivos. Todas as informações inseridas no widget são salvas em uma tabela.

Para adicionar um widget, acesse “Widgets” - “Widgets de Pesquisas” e adicione um novo widget usando o botão correspondente. É possível criar um número ilimitado de widgets. Para utilizá-lo, será necessário ativá-lo.

Documento para salvar os dados

Documento ou planilha específica onde os resultados do preenchimento do widget serão armazenados. O documento pode estar na pasta raiz ou em qualquer outra pasta. Cada vez que um visitante salvar os dados, uma nova linha será adicionada ao final da tabela.

Campos do widget

A principal área do widget consiste em vários elementos, como campos de entrada, blocos de texto, listas suspensas e outros tipos de componentes.

Para cada campo, é necessário especificar:

• Título do campo, que será exibido ao lado do campo a ser preenchido, como “Nome e Sobrenome” ou “Endereço de e-mail”.
• Tipo de campo, que define a aparência e funcionalidade do campo.
• Texto de ajuda, exibido logo abaixo do campo.
• Salvar na coluna, indicando em qual coluna os dados serão armazenados. A coluna pode ser identificada por uma letra ou por um nome de variável.
• Preenchimento obrigatório. Se esta opção estiver ativada, o visitante será obrigado a preencher o campo antes de enviar os dados.

Para excluir um campo, há o botão “Excluir”, e para adicionar um novo campo, clique em “Adicionar”.

Os campos serão exibidos no widget na ordem em que foram configurados. É possível alterar essa ordem arrastando-os com o mouse para a posição desejada.

Configurações do widget

• Título do widget. Texto exibido no cabeçalho do widget.
• A descrição abaixo do título pode conter informações adicionais ou dicas sobre como preencher o formulário.
• Texto do botão de envio. O botão que envia os dados. O padrão é “Enviar”, mas pode ser personalizado conforme necessário.
• Mensagem após o envio. Exibida assim que o widget for preenchido e enviado.

Autenticação

Os parâmetros de autenticação determinam quem pode usar o widget.

• Sem autenticação. Qualquer visitante pode preencher o widget. Se houver campos como %email ou %phone, essas informações serão simplesmente salvas sem verificação.

• Por e-mail. Esta opção de autenticação garante que o endereço de e-mail inserido pertence ao visitante, enviando um código único para confirmação. Se o código não for inserido corretamente, os dados não serão salvos.

  Para ativar a autenticação por e-mail, a tabela deve conter uma coluna chamada “Endereço de e-mail” e o widget deve ter um campo vinculado a %email com o parâmetro “Preenchimento obrigatório” ativado.

  O parâmetro “Remetente” define qual remetente será utilizado para enviar o código único.

  Autenticação por lista. Se ativada, além da verificação do endereço de e-mail, também será validada a presença desse e-mail em uma tabela específica. Isso permite restringir o acesso ao widget a um grupo pré-definido de usuários. Para configurar, basta clicar em “Configurar”, selecionar a tabela que contém a lista de e-mails e especificar a coluna correspondente. O botão “Excluir linha” permite remover automaticamente da tabela os e-mails utilizados, garantindo que cada endereço só possa ser usado uma única vez.

• Por número de telefone. Este tipo de autenticação garante que o número de telefone pertence ao visitante por meio do envio de uma chamada curta. O visitante precisará inserir os últimos 4 dígitos do número da chamada recebida. Caso contrário, os dados não serão salvos.

  Para ativar a autenticação por telefone, a tabela deve conter uma coluna chamada “Número de telefone”, e o widget deve ter um campo vinculado a %phone com o parâmetro “Preenchimento obrigatório” ativado.

  Autenticação por lista. Se ativada, além da confirmação do número de telefone, será validada sua presença em uma tabela específica. Isso permite restringir o acesso ao widget apenas a usuários pré-cadastrados. Para configurar, clique em “Configurar” e selecione a tabela onde os números estão salvos, especificando a coluna correspondente. Os números devem estar em formato internacional, apenas com “+” no início, como +5511999999999.

  O botão “Excluir linha” permite remover automaticamente da tabela os números já utilizados, garantindo que cada número só possa ser usado uma única vez.

Permitir preenchimento único

Se esta opção estiver ativada, o visitante só poderá preencher o widget uma única vez com um determinado endereço de e-mail ou número de telefone. Se a autenticação estiver ativada, será necessário confirmar a posse do endereço ou número antes do envio. Se a autenticação não estiver ativada, basta inserir um e-mail ou número diferente para enviar novamente. O método mais seguro para restringir múltiplos envios é a autenticação por uma lista pré-definida. Caso isso não seja possível, a autenticação por telefone reduz a quantidade de envios repetidos.

Personalização

Permite ajustar a cor principal do widget (botões e elementos principais), a cor do texto dos botões e adicionar estilos CSS personalizados para os elementos do widget.

Domínio

Neste campo, deve ser especificado o domínio onde o widget será integrado. Se alguém tentar inserir o código em outro site, o widget não funcionará. Se o widget for utilizado apenas via link, sem incorporação em um site, esse campo pode ser deixado em branco.

Código para o site

Para exibir o widget em um site, copie e cole o código indicado na seção correspondente. O código deve ser inserido exatamente onde o widget deve aparecer, por exemplo, em uma página específica do site destinada à pesquisa. Se o sistema de gerenciamento do site permitir a inclusão de código JavaScript, deve-se utilizar a versão padrão do código. Caso contrário, uma versão simplificada pode ser usada. A diferença é que, na versão simplificada, o widget terá uma altura fixa e uma barra de rolagem própria, enquanto a versão padrão ajustará sua altura automaticamente, sem barras adicionais de rolagem.

Acesso por link

O widget pode ser acessado diretamente por um link que pode ser enviado aos destinatários. Para isso, basta ativar a opção de uso por link e copiá-lo.

Modificação do widget

Se for necessário modificar o widget dinamicamente, ajustando determinadas configurações dependendo da página do site onde ele está sendo exibido, é possível utilizar uma tabela modificadora. Isso é útil para instalar vários widgets no site, alterar rapidamente o modelo de e-mail, a cor da interface ou até mesmo o documento associado, sem precisar criar um novo widget. Saiba mais.