Zum Hauptinhalt springen
Última modificação: 8 de outubro de 2025
Use conteúdo programável para personalizar os e-mails com dados da sua conta da HubSpot usando HubL. As fontes de dados que você pode usar em um e-mail programável dependem da sua assinatura do HubSpot:
  • Se você tiver uma assinatura Marketing Hub Professional, poderá usar os dados de objetos padrão do CRM, como contatos, empresas e produtos.
  • Se você tiver uma assinatura Marketing Hub Enterprise, também poderá usar fontes estruturadas como tabelas do HubDB e objetos personalizados. Esses dados podem ser filtrados com base nas propriedades de contato do destinatário.
Por exemplo, um site imobiliário poderia ter um formulário para os prospects preencherem com suas necessidades residenciais. O envio de formulário pode acionar um fluxo de trabalho que envia ao prospect um e-mail com imóveis nos quais ele pode estar interessado.

Limites de envio de e-mail

Você pode incluir as funções HubL de CRM crm_object, crm_objects e crm_associations em um e-mail programável, mas qualquer e-mail que inclua essas funções específicas estará sujeito aos limites abaixo, que se baseiam no número de destinatários para os quais você está enviando:
500.0001
250.0002
165.0003
125.0004
100.0005
Enviar um e-mail que atenda ou exceda esses limites vai atrasar ou cancelar o envio do e-mail. Além dos limites descritos acima, esteja ciente das advertências adicionais listadas abaixo:
  • Se você clonar um e-mail programável, ele não poderá ser enviado enquanto o original ainda estiver em processamento. Você deve aguardar pelo menos 1 hora entre cada envio de e-mail.
  • Você não pode conduzir um teste A/B para um e-mail programável que inclua uma função HubL crm_object, crm_objects ou crm_associations. Os e-mails enviados usando essas funções têm tempos de envio significativamente mais lentos do que outros e-mails, o que pode produzir resultados de teste imprecisos.

1. Crie um módulo de e-mail programável

Para criar o módulo de e-mail para acessar seus dados do HubDB ou do objeto personalizado:
  • Na sua conta da HubSpot, vá em Marketing > Arquivos e Modelos > Ferramentas de design.
  • No canto superior esquerdo, clique em Arquivo e selecione Novo arquivo.
  • Na caixa de diálogo, selecione Módulo para o tipo de arquivo e clique em Próximo. Em seguida, marque a caixa de seleção E-mails e insira um nome para o arquivo.
  • Clique em Criar.
  • Para ativar o e-mail programável para o módulo:
    • No inspetor à direita, ative a opção Ativar módulo para versão beta do e-mail programável.
    programmable-email-switch0
  • Você também pode habilitar o e-mail programável para um modelo de e-mail codificado adicionando isEnabledForEmailV3Rendering: true à parte superior do arquivo. enable-design-manager-template-for-programmable-email
Com o módulo criado, você adicionará o código para acessar os dados do seu CRM. Os exemplos a seguir demonstram como consultar de diferentes fontes de dados.

Objetos padrão

Você pode usar as funções HubL, como crm_object, crm_objects e crm_associations para consultar dados de objetos padrão em sua conta, como contatos, empresas ou produtos. O código a seguir usa a função HubL crm_object para consultar os dados de um produto com ID 2444498793 e renderizar o nome, a descrição e o preço:
{% set product = crm_object("product", 2444498793, "name,description,price") %}

<div>
  <p>
    <span>Name: </span>
    <span>{{ product.name }}</span>
  </p>
  <p>
    <span>Description: </span>
    <span>{{ product.description }}</span>
  </p>
  <p>
    <span>Price: </span>
    <span>{{ product.price }}</span>
  </p>
</div>

Objetos personalizados

Se você tiver uma conta do Marketing Hub Enterprise, poderá consultar os dados de um objeto personalizado criado na sua conta. O código abaixo recupera dados de um objeto personalizado chamado Propriedade, retornando valores (por exemplo, local, preço) armazenados nas propriedades do objeto personalizado. Observe que o exemplo abaixo usa o nome totalmente qualificado do objeto personalizado como primeiro argumento ao invocar a crm_objects função do HubL.
  • O nome totalmente qualificado começa com o ID da conta da HubSpot (prefixado com p), seguido por um sublinhado e o nome em plural em letra minúscula do objeto personalizado (por exemplo, properties).
  • Você pode recuperar um objeto fullyQualifiedName fazendo uma solicitação GET à API de esquema de objetos.
{% set real_estate_listings = crm_objects("p2990812_properties", "", "listing_name,location, price, address, type") %}

{% for home in real_estate_listings.results %}
    {{ home.address}} <br>
	{{ home.price }} <br>
	<img
	alt="{{ home.name }}"
	src="{{ home.hero_image }}"
	style="outline: none; max-width: 100%;"
	width="260px"
	/>
	<br>
	<hr>
{% endfor %}
Para filtrar os dados retornados para cada destinatário, você pode adicionar um parâmetro query que filtrará os resultados pelas propriedades de contato do destinatário. Veja a lista completa de opções de filtro.
{% set query = "price__lte="~contact.budget_max|int~"&price__gte="~contact.budget_min|int~"&city="~contact.city"&order=listing_name" %}
{% set real_estate_listings = crm_objects("p2990812_Property", query, "listing_name,location, price, address, type") %}
{% for home in real_estate_listings.results %}

  ...

{% endfor %}

HubDB

Se você tiver uma conta do Marketing Hub Enterprise, poderá usar os dados da tabela HubDB no e-mail. O código a seguir usa a função HubL hubdb_table_rows para recuperar todos os dados da tabela. Isso listará todas as propriedades imobiliárias no e-mail, apresentando os detalhes de cada propriedade junto com sua imagem.
{% set real_estate_listings = hubdb_table_rows(1234567) %}

{% for home in real_estate_listings%}
    {{ home.address}} <br>
	{{ home.price }} <br>
	<img
	alt="{{ home.name }}"
	src="{{ home.hero_image.url }}"
	style="outline: none; max-width: 100%;"
	width="260px"
	/>
	<br>
	<hr>
{% endfor %}
Para filtrar os dados retornados para cada destinatário, você pode adicionar um parâmetro query que filtrará os resultados pelas propriedades de contato especificadas. Veja a lista completa de opções de filtro.
{% set query = "price__lte="~contact.budget_max|int~"&price__gte="~contact.budget_min|int~"&persona="~contact.hs_persona.value~"&order=listing_name" %}

{% for home in real_estate_listings %}

	...

{% endfor %}

2. Adicionar o módulo a um e-mail

Com o módulo publicado, você o adicionará ao corpo do e-mail de arrastar e soltar.
  • Na sua conta da HubSpot, acesse Marketing > E-mail.
  • Selecione o email que você criou.
  • Na barra lateral esquerda, em Conteúdo, clique em Mais. Localize seu módulo de e-mail programável e arraste-o para o corpo do email.
drag-and-drop-email-editor-more-modules Se você tiver configurado o módulo para filtrar dados por propriedades de contato específicas, a visualização do e-mail aparecerá em branco. Isso ocorre porque a ferramenta de e-mail não foi definida para visualizar o e-mail como um contato específico. Para visualizar a aparência do e-mail como um contato específico:
  • No canto superior direito, clique em Ações e selecione Visualizar.
email-actions-menu0
  • Na próxima tela, clique no menu suspenso Visualizar como um contato específico, depois selecione um contato.
preview-email-as-specific-contact0 Agora você deve ver apenas os dados relevantes para o destinatário, filtrados por suas propriedades de contato. Captura de tela da visualização do e-mail Se um módulo ou modelo de e-mail contiver código personalizado com HubL não resolvido, um módulo de espaço reservado aparecerá em seu lugar. placeholder-module-in-programmable-email

Mais tutoriais focados no HubDB

HubSpot Academy

I