 Widget de Pesquisas

Com o widget de pesquisas, é possível coletar dados para posteriormente criar arquivos. Todas as informações inseridas no widget são salvas em uma tabela.

Para adicionar o widget, é necessário abrir “Widgets” - “Widgets de Pesquisas” e adicionar o widget usando o botão apropriado. É possível criar um número ilimitado de widgets. Para utilizá-lo, ele deve ser ativado.

Documento para salvar dados

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

Campos do widget

A área principal do widget é composta por diversos elementos - campos de entrada, blocos de texto, listas suspensas e assim por diante.

Para cada campo, é necessário especificar:

• Título do campo, que será exibido próximo ao campo obrigatório, como “Nome e Sobrenome” ou “Endereço de Email”.
• Tipo do campo: define a aparência do campo.
• Texto de ajuda: mostrado logo abaixo do campo.
• Salvar na coluna: indica a coluna onde o resultado será salvo. A coluna pode estar identificada por uma letra ou uma variável.
• Obrigatório: Caso a opção esteja ativada, o visitante será obrigado a preencher este campo.

Para excluir um campo, use o botão "Excluir", e para adicionar outro, use o botão "Adicionar".

Os campos serão exibidos no widget na ordem em que forem configurados. A ordem pode ser alterada arrastando o campo com o mouse e soltando-o na posição desejada.

Configurações do widget

• Título do widget: Texto inserido no cabeçalho do widget.
• Na descrição abaixo do título, é possível incluir informações adicionais ou instruções para preencher o widget.
• Texto do botão, que envia os dados. Por padrão, é “Enviar”, mas você pode inserir qualquer texto personalizado.
• Mensagem após enviar os dados: exibida após o preenchimento do widget.

Autenticação

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

• Sem autenticação. Qualquer visitante pode preencher o widget. Se houver variáveis %email ou %phone nos campos, esses dados serão apenas salvos sem verificação.

• Por email: Este tipo de autenticação garante que o endereço de email pertence ao visitante ao enviar um código único para seu endereço. Caso o código não seja inserido no widget, os dados não serão salvos.

  Para autenticação por email, a tabela deve conter uma coluna “Endereço de Email”, e no widget deve haver um campo vinculado à coluna %email com a opção “Obrigatório” ativada.

  O parâmetro “Remetente” permite especificar qual remetente usar para enviar o email com o código único.

  Autenticação por lista: quando ativada, é verificada não apenas a posse do endereço fornecido, mas também sua presença em uma tabela específica. Esta funcionalidade permite delimitar previamente o grupo de pessoas autorizadas a usar o widget. Para isso, clique em “Configurar” abaixo dessa opção. Na janela que abrir, escolha a tabela (ou documento com a tabela) onde estão armazenados os endereços e selecione a coluna correspondente. A opção “Excluir linha” permite determinar se a linha com esse endereço será excluída da tabela. Assim, na tabela permanecerão apenas os endereços ainda não utilizados para autenticação.

• Por número de telefone: Este tipo de autenticação verifica a propriedade do número enviado ao realizar uma chamada curta. O visitante deverá inserir os 4 últimos dígitos do número de retorno. Caso contrário, os dados não serão salvos.

  Para autenticação por telefone, a tabela deve conter uma coluna “Número de Telefone”, e no widget deve haver um campo vinculado à coluna %phone com a opção “Obrigatório” ativada.

  Autenticação por lista: Quando ativada, além de validar a propriedade do número, verifica-se a presença do mesmo em uma tabela específica. Para isso, clique em “Configurar” abaixo desta opção. Na janela que aparece, selecione a tabela (ou um documento contendo a tabela) onde os números estão armazenados. Estes devem estar no formato internacional, apenas com símbolo “+” no início, exemplo: +5511999999999. Para ajustar os números, use a função “Localizar e Substituir” da ferramenta. A opção “Excluir linha” determina a remoção ou não da linha relacionada a esse número. Assim, permanecerão na tabela apenas os números ainda não utilizados.

Permitir preenchimento único

Se esta configuração estiver ativada, o visitante poderá preencher o widget apenas uma vez utilizando o mesmo email ou número de telefone. Caso esteja usando autenticação, será necessário confirmar a propriedade do email ou número antes de acessar novamente. Sem autenticação, basta inserir outro email ou número para reutilizar o widget. Dessa forma, a opção mais segura para restringir vários usos é a autenticação por lista previamente determinada. Caso isso não seja possível, a autenticação pelo número de telefone reduz a probabilidade de uso repetido.

Estilos

É possível configurar a cor principal do widget (botões e elementos principais) e a cor do texto do botão. Também é viável definir estilos CSS personalizados para os elementos do widget.

Domínio

Neste campo, insira o domínio onde o widget será usado. Se alguém tentar inserir o código em outro site, o widget não funcionará. Caso planeje usar o widget via link, sem integração com um site, esse campo pode ser deixado em branco.

Código para o site

Para exibir o widget no site, insira o código indicado nesta seção no local desejado da página. Essa localização determina onde o widget será exibido, podendo ser, por exemplo, uma página específica dedicada à criação. Se o sistema do site permitir a inserção de código JavaScript, use o código padrão. Caso contrário, utilize o código simplificado. A diferença é que, com o código simplificado, o widget terá uma altura padrão e terá sua própria barra de rolagem. Com o código padrão, a altura será ajustada automaticamente ao widget, sem necessidade de elementos roláveis adicionais.

Acesso via link

O widget pode ser aberto através de um link que será enviado aos destinatários. Para isso, ative a opção de uso por link e copie o URL fornecido.

Modificação do widget

Se for necessário modificar o widget dinamicamente, ajustando configurações com base na página aberta no site, pode-se utilizar uma tabela modificadora. Isso é útil para instalar vários widgets em um único site ou alterar rapidamente o modelo de email, cores ou até o documento sem criar um widget separado. Saiba mais.