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.

Como usar expressões regulares para validar valores de propriedade

Ultima atualização: Fevereiro 5, 2025

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

Marketing Hub   Professional , Enterprise
Sales Hub   Professional , Enterprise
Service Hub   Professional , Enterprise
Operations Hub   Professional , Enterprise
Content Hub   Professional , Enterprise

Para melhorar a consistência e a qualidade dos dados do seu CRM, você pode usar expressões regulares (regexes) para validar os valores das propriedades de texto. Regexes são sequências de caracteres que definem um padrão de texto desejado. Por exemplo, você pode exigir valores com um determinado número de dígitos ou incluir caracteres específicos e formatos definidos.

Neste artigo, você aprendará a adicionar expressões regulares às regras de validação de uma propriedade e revisar casos de uso de exemplo.

Observe o seguinte: O mecanismo regex da HubSpot não suporta grupos de captura de suporte. Você pode usar expressões regulares para correspondência de padrões, mas não será possível utilizar recursos associados a grupos de captura, como: extrair partes da correspondência para uso posterior, referenciar valores capturados dentro da própria expressão (backreferences) ou armazenar resultados de correspondência em variáveis ou grupos.

Adicionar regras de validação de regex a uma propriedade

Você pode adicionar expressões regulares às regras de validação de propriedade de texto. Se você tiver acesso à versão beta de Expressões Regulares Geradas por IA para Validações de Propriedades, também poderá usar a IA para escrever expressões regulares conforme seu objetivo.

  • Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
  • No menu da barra lateral esquerda, acesse Propriedades.

  • Clique no menu suspenso Selecionar um objeto, depois selecione Propriedades do [objeto] para criar ou editar uma propriedade para esse objeto.

  • Crie ou edite uma propriedade com o texto de linha única ou com o texto de várias linhas Ao usar regras de validação de regex, há um limite de 1.000 caracteres para a propriedade.
  • No editor de propriedades, navegue até a aba Regras .
  • Para configurar a validação usando expressões regulares, selecione Validar usando expressão regular (regex). Se quiser usar regras simples, aprenda como configurar outras regras de validação.
  • Para configurar manualmente a expressão regular, insira sua expressão no campo Regex. Para gerar a expressão regular com AI (BETA), clique em Gerar, insira uma descrição de como a propriedade deve ser validada e clique em Gerar.
  • Digite uma mensagem de erro no campo Mensagem de valor inválido . Isso é exibido aos usuários quando o valor inserido não atende aos requisitos de validação.
  • Para adicionar mais detalhes à sua mensagem de erro, digite uma mensagem de ajuda adicional opcional.
  • Para testar a validação, insira um valor. Se o regex funcionar, um valor inválido resultará em um erro, enquanto um valor válido será aceito.

  • Conclua a configuração ou edição da propriedade e clique em Criar ou Salvar.

As regras de validação se aplicam quando os usuários definem ou editam o valor da propriedade durante a criação, em um registro, na página de índice de objeto, via importação ou por meio de envios a formulários criados por meio do novo editor de formulários.

Sintaxe Regex

Para obter orientação sobre como configurar sua expressão regular, consulte esta folha de ajuda Regex.

Expressões de exemplo

Alguns exemplos de casos de uso incluem:

Observe: antes de implementar as expressões a seguir, você deve verificar se elas funcionam para seu caso de uso específico.

  • Número de telefone dos EUA: para exigir que os números de telefone sejam inseridos no formato (123) 456-7890, use o regex ^\(\d{3}\) \d{3}-\d{4}$.
  • Endereço de e-mail: para validar se um valor inserido segue um formato de e-mail padrão (por exemplo, user@example.com), você pode usar o regex ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$.
  • CEP: para exigir que os CEPs tenham cinco dígitos, você pode usar o regex ^\d{5}$.
  • URL: para validar um URL que comece com "http://" ou "https://", você pode usar o regex ^https?:\/\/[^\s/$.?#].[^\s]*$.
  • Sem espaços em branco: para evitar que os espaços em branco sejam inseridos, você poderá usar o regex ^\S*$
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.