- Central de conhecimento
- Marketing
- Formulários
- Preencher automaticamente campos de formulário com uma linha de consulta
Preencher automaticamente campos de formulário com uma linha de consulta
Ultima atualização: 17 de Setembro de 2025
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
Você pode preencher automaticamente os campos de formulário em uma página adicionando strings de consulta à URL da página antes de enviá-lo aos seus contatos. Os campos serão preenchidos com base na string de consulta adicionada. Isso também funciona para campos de formulário ocultos. Por exemplo, você pode criar propriedades UTM personalizadas e usar parâmetros UTM para preencher automaticamente um campo de formulário oculto.
Compreender limitações e considerações
- Cadeias de caracteres de consulta não podem preencher campos de formulário dependentes automaticamente.
- Campos de formulário dependentes não podem ser disparados com base em vários valores em uma cadeia de caracteres de consulta.
Criar cadeias de caracteres de consulta estáticas com valores predefinidos
Para criar uma URL com uma string de consulta estática, você precisará copiar o nome da propriedade interna de quaisquer campos que deseja preencher automaticamente e adicioná-los ao final da URL da página.
Copiar o nome interno da propriedade
- Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
- No menu da barra lateral esquerda, vá para Propriedades.
- Clique no nome de uma propriedade para preencher previamente os valores.
- Copiar o nome internoda propriedade. Saiba mais sobre nomes de propriedades internas.
- Repita isso para quaisquer outras propriedades para as quais você deseja preencher automaticamente os valores no formulário.
Criar sua URL com cadeias de caracteres de consulta estáticas
Após copiar os nomes das propriedades internas, configure o URL da página que você enviará aos seus contatos.
- No navegador, acesse a página do seu formulário. Em seguida, copie o URL.
- Adicionar um sinal de interrogação (?) ao final do URL da página.
- Adicione o nome interno da propriedade, seguido por um sinal de igual e o valor para preencher automaticamente no campo. Anote as regras para adicionar valores, dependendo do tipo de campo da propriedade:
- Caixa de seleção única: as sequências de consulta devem conter umvalor verdadeiro ou falso, não sim ou não.
- Selecionador de data: As sequências de consulta devem conter um valor de data em um formato AAAA-MM-DD.
- Várias caixas de seleção:valores de linha de consulta devem coincidir exatamente com as opções de valor da propriedade, com uma divisão de vários valores.
- Seleção de botões de seleção/menu suspenso: valores de linha de consulta devem corresponder exatamente às opções de valor da propriedade.
- Para todos os tipos de campo: ao criar strings de consulta, essas regras se aplicam a todos os tipos de campo.
- Os espaços em um valor de propriedade devem ser separados por %20.
- Várias propriedades diferentes devem ser separadas com um "e" comercial (&).
URL de exemplo com uma cadeia de consulta estática
Após criar o URL com as sequências de consulta estática, você pode usá-lo como um link em seu conteúdo, como e-mails e páginas. Um contato que clicar no link verá o formulário na página preenchido automaticamente com os valores predefinidos na string de consulta. Veja um exemplo e um detalhamento de uma URL com strings de consulta estática formatadas corretamente:http://www.domain.com/marketing-offer?firstname=John&lastname=Smith&email=jsmith@email.com
&favorite_season=Winter%20Season&favorite_fast_food=Burger;Taco&number_property=7
&will_you_come_to_the_party=Maybe&do_you_like_parties=true&date_of_party=2018-10-24
- Início da string de consulta e campo de texto de linha única: ?firstname=John
- Campo de texto de linha única:&sobrenome=Smith
- Campo de texto de linha única:&e-mail=jsmik@e-mail.com
- Campo de seleção do menu suspenso: &favorite_season=Winter%20Season
- Vários campos de caixas de seleção: &favorite_fast_food=Burger;Tacos
- Campo de números:&número_favorito=7
- Campo de seleção de e-mail:&você_irá_vir_para_a_festa=Talvez
- Campo de caixa de seleção única:&você_gosta_de_festas=verdadeiro
- Campo selecionador de datas: &date_of_party=2018-10-2
Criar cadeias de caracteres de consulta dinâmicas com tokens de personalização
Assinatura necessária Uma assinatura Enterprise ou Professional do Marketing hub é necessária para criar cadeias de caracteres de consulta dinâmicas.
Você pode usar tokens de personalização para criar strings de consulta dinâmicas que preencherão automaticamente os campos de formulário com base em propriedades de contato conhecidas.
Observação:
- As strings de consulta dinâmicas com tokens de personalização somente funcionarão corretamente quando o URL for direcionado para uma página hospedada pela HubSpot com um formulário da HubSpot.
- Esta funcionalidade não funcionará se o URL for direcionado para uma página de formulário independente da HubSpot.
- A URL com as strings de consulta dinâmica também deve ser colocada no conteúdo do HubSpot ou em uma página externa com o código de rastreamento do HubSpot.
Recupere seu token de personalização
Primeiro, recupere os tokens de personalização necessários para criar as strings de consulta. Para recuperar um token de personalização de uma propriedade:
- Na sua conta da HubSpot, navegue até Marketing > E-mail.
- Clique em Criar email ou clique no nome de um rascunho de email.
- Na barra de ferramentas de rich text, clique em Personalizar.
- Configure seus tokens de personalização:
- Na caixa de diálogo, selecione um token de personalização para preencher automaticamente no seu formulário.
- Marque a caixa de seleção Usar o valor padrão global dessa propriedade ao inserir o token de personalização.
- Continue adicionando tokens de personalização adicionais se necessário.


- Na barra de ferramentas de rich text, clique em Mais e selecione o codef ícone código-fonte para exibir o HTML do seu email.
- No código fonte, você verá o código bruto para cada token de personalização adicionado ao corpo do e-mail. Cada token será fechado com sinal de cerquilha duplo ([ ]) {{ }}. Destaque um token (por exemplo,
{{ contact.firstname }}
), clique com o botão direito do mouse e selecione Copiar. - Repita isso para qualquer tokens de personalização que você deseja pré-preencher no seu formulario.
- Na parte inferior da caixa de diálogo, clique em Cancelar e em fechar para sair do código-fonte.
Criar seu URL com strings de consulta dinâmicas
Use os tokens de personalização para criar um URL com strings de consulta dinâmicas. Este URL pode ser usado como um link no conteúdo do HubSpot, como emails e páginas, ou como uma página externa com o código de rastreamento do HubSpot. Um contato que clicar no link verá o formulário na página preenchido automaticamente com suas informações se tiver valores conhecidos para os campos nas string de consulta.
Para criar um URL com strings de consulta dinâmicas:
- No navegador, acesse a página do seu formulário. Em seguida, copie o URL.
- Usando o URL da página e os tokens de personalização, formate sua string de consulta dinâmica:
- Adicionar um sinal de interrogação (?) ao final do URL da página.
- Acrescentar o nome interno da propriedade, seguido de um sinal de igual e do token de personalização. Verifique se todos os espaços foram removidos do token (por exemplo, {{contact.firstname}} ).
- Separe várias propriedades com "e" comercial (&).
- Aqui está um exemplo de uma URL com strings de consulta dinâmica formatadas adequadamente:
http://www.domain.com/marketing-offer?firstname={{contact.firstname}}&lastname={{contact.lastname}}&email={{contact.email}}