Ir para o conteúdo principal
Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.

Solucionar problemas de formulários HubSpot

Ultima atualização: 1 de Outubro de 2025

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Os formulários HubSpot permitem gerar leads a partir do seu site e coletar informações importantes sobre seus visitantes e contatos no HubSpot. Se estiver tendo dificuldades com o comportamento do seu formulário ou com seus envios, confira os diferentes problemas comuns e as etapas para resolvê-los. 

Etapas gerais de solução de problemas 

Se você estiver tendo problemas com os envios de formulários, isso pode ser causado pelo próprio formulário HubSpot ou pela página na qual o formulário está incorporado. Para solucionar o problema, você pode testar o formulário da HubSpot:

  1. Abra o URL da página independente do formulário em outra guia do navegador. Esta página independente não tem nenhum elemento que possa afetar o formulário.
  2. Faça um envio de teste para o formulário.
  3. Verifique o envio de teste:
    • Se o envio for bem-sucedido, é provável que o problema esteja relacionado à página em que ele está incorporado. Verifique com seu desenvolvedor sobre os possíveis elementos na página que poderiam estar afetando os envios, como scripts ou folhas de estilo anexadas.
    • Se o envio também for afetado pelo mesmo erro, entre em contato com o Suporte da HubSpot.

Solucionar problemas comuns de comportamento do formulário

Veja abaixo alguns problemas comuns que você pode encontrar ao configurar seu formulário e as etapas típicas para a resolução. Depois de atualizar o formulário, publique-o e verifique-o novamente.

Erro Etapas para resolver o erro

Um campo não aparece em um formulário ativo

Confirme se o formulário atualizado foi publicado verificando o URL da página independente do formulário em outra guia do navegador.

Se alguns campos ainda não estiverem sendo exibidos no formulário quando você adicioná-lo a uma página, é provável que o formulário tenha campos progressivos e o HubSpot se lembre do visitante de interações ou testes anteriores. Os campos progressivos são ocultados se o visitante preencheu o campo previamente ou se o contato já tiver um valor para a propriedade.

Se quiser que o campo seja exibido de forma consistente, adicione o campo como um campo de formulário regular em vez de um campo de formulário progressivo. 

O formulário adicionado à página HubSpot não exibe a mesma mensagem de agradecimento que no editor de formulários (antigo)

Quando um formulário (antigo) é adicionado a uma página HubSpot, a mensagem de agradecimento definida no editor de página substitui a do editor de formulário. Isso acontece quando o formulário é definido como uma mensagem de agradecimento integrada ou como um redirecionamento a uma página HubSpot ou externa. 

Como resultado, ao adicionar um formulário criado no editor antigo a uma página HubSpot, você deve definir a mensagem de agradecimento integrada ou redirecionar para outra página dentro do módulo de formulário do editor de página.

Isso não se aplica a redirecionamentos de formulários condicionais ou ao redirecionar para uma página de agendamento. Estes têm prioridade quando definidos no editor de formulários.

A propriedade não está disponível como um campo no editor de formulários

 

Se uma propriedade não estiver disponível como um campo de formulário, pode ser porque ela não está configurada para aparecer em formulários. Para habilitar uma propriedade para ser exibida em formulários: 
  1. Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
  2. No menu da barra lateral esquerda, vá para Propriedades.
  3. Clique no nome da propriedade.
  4. No menu da barra lateral esquerda, navegue até Regras
  5. Marque a caixa de seleção Mostrar propriedade em formulários. Se sua propriedade tiver várias opções, a opção Mostrar em formulários deverá estar ativada para cada opção que você deseja usar em seus formulários.
  6. No canto superior direito, clique em Salvar.
O editor de propriedade, exibindo opções de propriedade de menu suspenso, com destaque para a opção para mostrar os valores nos formulários.

 

O conteúdo inteligente não aparece na minha página de agradecimento

Você não pode usar conteúdo inteligente em uma página de agradecimento.

Quando um visitante envia um formulário e é redirecionado para uma página de agradecimento, não há tempo suficiente para o formulário ser processado e para a HubSpot determinar se o contato atende às regras de conteúdo inteligente da página de agradecimento.

Erro: Você forneceu HTML de rich text inseguro

O erro Você forneceu HTML de rich text inseguro ocorre como resultado da inclusão de tags HTML ou atributos que não são permitidos em seu formulário.

Para corrigir esse erro e salvar seu formulário, verifique o código fonte das áreas de rich text em seu formulário em relação ao seguinte:

  • Não são permitidas tags <script> e elas devem ser removidas.
  • Nenhum atributo HTML de script (por ex., "onmouseover", "onclick"), é permitido e deverá ser removido.
  • Todas as URLs em imagens devem começar com "http://" ou "https://".
  • Todas as URLs de link devem começar com "http://", 'https://", "mailto:" ou "tel:".
  • As tags de link só podem ter atributos HTM do tipo "href", "target", "name" e "rel".

Solucionar problemas comuns de envio de formulário

Veja abaixo alguns problemas comuns que você pode encontrar com os envios de formulários e as etapas típicas para a resolução. Depois de atualizar o formulário, você pode tentar publicá-lo e verificá-lo novamente. 

Erro Etapas para resolver o erro

Número de envios de formulário superior aos contatos / Nenhum registro de contato criado para um envio de formulário

Os envios de formulários são registrados quando o botão Enviar em um formulário é clicado e processado. Estes são alguns motivos comuns pelos quais o número de envios de formulários pode ser maior do que o número de contatos criados: 
  • O formulário foi enviado várias vezes com o mesmo endereço de e-mail. Quando isso acontecer, apenas um contato será criado, mas cada envio de formulário ainda será registrado. Para evitar isso, na guia Opções do formulário, ative a configuração Sempre criar contato para novo endereço de e-mail
  • Os contatos podem ter sido excluídos. Se um contato for excluído do HubSpot, seu envio de formulário ainda contará para o total, mas o contato não aparecerá mais em uma lista filtrada por envios de formulário.
  • O campo E-mail não estava preenchido quando o formulário foi enviado. Para um envio de formulário gerar um registro de contato no HubSpot, o campo de e-mail padrão deve ser usado em seu formulário. Caso contrário, você deve permitir envios de formulário sem endereços de e-mail para gerar contatos.
  • O envio de formulário usou um endereço de e-mail já associado a um registro de contato. Ou o envio de formulário foi preenchido em um navegador com cookies de rastreamento associados a um registro de contato existente. Nesse cenário, o envio atualizará o registro de contato existente e não criará um novo. Saiba mais sobre como o HubSpot deduplica os contatos e como recriar os contatos sobrescritos pelos envios de formulários.

O contato não registro uma exibição de página ao enviar o formulário

 

Para rastrear corretamente os modos de exibição de página, verifique se o código de rastreamento da HubSpot está instalado no seu site e se está sendo acionado corretamente.

Se o código de rastreamento estiver instalado e sendo acionado corretamente, mas o valor da propriedade Número de exibições de página em um contato ainda for "0", é provável que os cookies tenham sido bloqueados quando o contato enviou o formulário. Isso pode acontecer por vários motivos:

Envio de formulário não aparece na linha do tempo de atividades de objetos associados

Para exibir um envio de formulário na linha do tempo da atividade de um objeto associado:
  • O formulário deve conter um campo de formulário que pertence a esse tipo de objeto.
  • O campo do formulário que pertence a esse tipo de objeto deve ser preenchido quando o formulário for enviado.

Por exemplo, se o formulário contiver uma propriedade de empresa definida como um campo de formulário e esse campo foi preenchido quando o formulário foi enviado, o envio de formulário será exibido na linha do tempo de atividades da empresa associada. Para garantir que o campo esteja sempre preenchido, você pode definir o campo do formulário como obrigatório

Erro de Nenhum registro de contato

Se você não permitir que envios de formulários sem endereços de e-mail criem contatos, há dois motivos pelos quais o erro Nenhum registro de contato pode ser exibido em seu envio de formulário:
  • O campo E-mail não está incluído ou é obrigatório no formulário.
  • O contato associado ao envio foi excluído do HubSpot.

Erro de Nenhum registro

Este erro significa que o HubSpot não pôde determinar onde o envio ocorreu. Isso pode acontecer por dois motivos:

Visita à página não registrada após o envio de formulário

Quando um envio de formulário não registra uma visita ao site, provavelmente é porque o endereço IP do visitante foi excluído das análises do site.
  • Se o visitante enviar o formulário usando um endereço IP excluído, o envio será registrado nas análises de envio de formulário, mas a visita à página não será contabilizada.
  • Se você for um usuário de uma conta da HubSpot e não usar um endereço IP excluído, seu envio de formulário e visita à página serão contabilizados.

Erro: Nenhum cookie foi encontrado para este envio

Este erro pode ser causado pelo seguinte:
  • O envio originou de uma integração externa via API da HubSpot e não incluía um cookie.
  • O navegador do visitante bloqueou o cookie.
  • O visitante não aceitou o banner de cookies.
  • O visitante enviou usando um endereço IP filtrado. 

Arquivo removido do envio de formulário do contato

A ferramenta de formulários da HubSpot está equipada com detecção de vírus que impede o carregamento de arquivos suspeitos nos envios de formulários.

Se um visitante enviar um formulário com um arquivo e for detectado um vírus, a mensagem [Nome do arquivo] removido do envio aparecerá nos detalhes do envio.

Informações adicionais da empresa são mostradas na minha notificação de formulário 

Se a HubSpot tiver informações adicionais sobre a empresa em seus bancos de dados, ela preencherá automaticamente essas informações na parte inferior da notificação.

Contato sem um valor para País do IP, Estado do IP ou Cidade do IP

 

O HubSpot usa vários bancos de dados de terceiros para tentar combinar o endereço IP do visitante com a sua localização geográfica. Há dois motivos pelos quais o País do IP, Estado/região do IP ou Cidade do IP de um contato podem estar em branco:
  • Os contatos devem enviar um formulário com o rastreamento de cookies habilitado ou interagir com (abrir ou clicar) um e-mail rastreado da HubSpot para um endereço IP associado.
  • A HubSpot não pôde encontrar uma correspondência para as propriedades de geolocalização em seus bancos de dados. Os dados de localização do endereço IP podem ser imprecisos ou irregulares em determinadas localizações geográficas, portanto, pode haver casos em que o HubSpot não consiga encontrar dados para todas as três propriedades IP.

Solucionar problemas comuns de exibição de formulários

Veja abaixo alguns problemas comuns que impedem que seu formulário seja mostrado em páginas externas ou páginas HubSpot e as etapas típicas para a resolução.

Erro Etapas para resolver o erro

O formulário não é mostrado em uma página externa ou HubSpot

Se o seu formulário não aparecer em páginas externas ou página HubSpot, pode haver código conflitante na página impedindo que ele seja exibido. A causa costuma ser o script OtAutoBlock.js do One Trust.

Por padrão, os formulários não serão mostrados em nenhuma das páginas em que este script é executado até os cookies serem aceitos pelos visitantes.

Para mostrar o formulário a todos os visitantes, incluindo os que não aceitaram os cookies, o script precisará ser gerenciado externamente. Você pode considerar as seguintes opções:

  • Configure os scripts de lista de permissões no script OtAutoBlock.js do OneTrust para permitir que o formulário seja renderizado. É recomendado trabalhar com seu desenvolvedor nessa questão.
  • Verifique com o OneTrust se é possível adicionar scripts de incorporação de formulário da HubSpot a uma lista de permissões. 
  • Remova completamente o script OtAutoBlock.js do OneTrust.

Observação: ao avaliar suas etapas de solução de problemas, trabalhar com banners de consentimento e considerar sua política de privacidade, sua equipe jurídica é o melhor recurso para fornecer orientações sobre conformidade para as circunstâncias específicas do seu negócio.

O formulário não é mostrado em uma página externa

Se o formulário não for exibido em uma página externa, pode haver um problema com o código de incorporação do formulário ou com o host do site. Saiba como solucionar problemas de formulários incorporados externamente

Um formulário incorporado está sendo exibido no local errado em uma página externa

Depois de incorporar um formulário HubSpot em uma página externa, se um formulário for renderizado em uma posição diferente da desejada, isso poderá ocorrer devido a: 
  • O formulário está sendo renderizado dinamicamente em uma página. 
  • Vários códigos de incorporação de formulário estão sendo adicionados à mesma tag <div>. 
  • O formulário não pode ser carregado porque um navegador mais antigo está sendo usado.

Saiba mais sobre como resolver esses problemas atualizando o código de incorporação de formulário. 

Erro "Tivemos alguns problemas ao carregar este formulário. Clique aqui para continuar"

Os formulários da HubSpot são criados com JavaScript para adicionar recursos como validação de campo, campos dependentes e mensagens de erro dinâmicas. No entanto, isso significa que as extensões do navegador de bloqueio de recursos, como o Ghostery e o Privacy Badger, podem impedir que seus formulários sejam carregados e exibidos se estiverem ativados. 

O texto Clique aqui para continuar está com hiperlink para https://www.hubspot.com/products/marketing/forms?utm_source=share.hsforms.com&utm_medium=referral&utm_campaign=hsforms-redirect, um domínio protegido controlado pelo HubSpot. Quando um visitante clica no link, ele é levado a uma página de formulário independente, na qual ele pode enviar o formulário.

O link inclui o contexto completo do código integrado ao formulário original em uma string de consulta, bem como as informações da página original, como seu título e URL. O formulário nesta página independente se comportará exatamente como o formulário original. Um envio de formulário na página independente passará as mesmas informações de análise que um envio em seu formulário original.

 

Esse artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.