G

M

Tabelas de Consulta

Como usar tabelas de consulta

Visão geral

As Tabelas de Consulta são uma maneira de você armazenar dados que pode usar em Modelos, Fluxos e Jornadas. Crie suas Tabelas de Consulta através do painel, e então faça referência dinâmica aos dados nessas tabelas

Tabelas de Consulta no Bird armazenam e centralizam referências de dados, que podem ser consultadas ao criar modelos de email usando a linguagem de template Liquid em HTML.

Por exemplo, as bandeiras de cada país, abreviações ou moedas podem ser armazenadas e atualizadas centralmente como uma tabela de consulta. Cada vez que são usadas na construção de um email, podem ser referenciadas a partir dessa tabela de consulta.

Limitações importantes:

  • Cada tabela pode ter até 10 itens de dados separados armazenados nela.

  • Cada item pode conter até aproximadamente 300kB de dados.

Criar uma Tabela de Pesquisa

Vá para Conteúdo > Tabelas de Pesquisa e clique em Criar.

  • Insira um nome de exibição

  • Insira um slug sem espaços



O Slug é usado para referenciar esta tabela e pode conter apenas caracteres alfanuméricos. Observe que esse slug é usado para referenciar o modelo de email

  • Clique em Salvar



Criando um item em uma tabela

Clique na tabela que você criou

Do menu de contexto que aparece, selecione "Visualizar"



Cada item em uma tabela é essencialmente um documento JSON. Isso significa que você pode construir uma estrutura de árvore de chaves e valores, onde os valores podem ser texto, números, booleanos, arrays ou objetos. Você pode inserir um documento JSON diretamente, usando a sintaxe JSON ou pode usar um editor de interface para construir o documento JSON.

Editor JSON

  • Depois de salvar, você verá um editor JSON. Você pode selecionar o editor de Texto ou o editor da UI de acordo com sua preferência.

  • Atualize a tabela de pesquisa usando uma estrutura JSON.

Adicionando um item

Para adicionar um item em um JSON para organização, clique em +Adicionar Item no painel esquerdo.

  • Digite um nome no topo

  • Clique no botão Adicionar Item

  • Uma vez criado, você pode ver o item criado no painel esquerdo.

Escreva o JSON

Use o formato JSON para definir qualquer estrutura de objeto e pares de chave-valor abaixo:

Por exemplo, um JSON que fornece o nome do país e a moeda local com base na abreviação do país

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Você também pode usar o editor da UI para definir a estrutura JSON.


Vá para Conteúdo > Tabelas de Pesquisa e clique em Criar.

  • Insira um nome de exibição

  • Insira um slug sem espaços



O Slug é usado para referenciar esta tabela e pode conter apenas caracteres alfanuméricos. Observe que esse slug é usado para referenciar o modelo de email

  • Clique em Salvar



Criando um item em uma tabela

Clique na tabela que você criou

Do menu de contexto que aparece, selecione "Visualizar"



Cada item em uma tabela é essencialmente um documento JSON. Isso significa que você pode construir uma estrutura de árvore de chaves e valores, onde os valores podem ser texto, números, booleanos, arrays ou objetos. Você pode inserir um documento JSON diretamente, usando a sintaxe JSON ou pode usar um editor de interface para construir o documento JSON.

Editor JSON

  • Depois de salvar, você verá um editor JSON. Você pode selecionar o editor de Texto ou o editor da UI de acordo com sua preferência.

  • Atualize a tabela de pesquisa usando uma estrutura JSON.

Adicionando um item

Para adicionar um item em um JSON para organização, clique em +Adicionar Item no painel esquerdo.

  • Digite um nome no topo

  • Clique no botão Adicionar Item

  • Uma vez criado, você pode ver o item criado no painel esquerdo.

Escreva o JSON

Use o formato JSON para definir qualquer estrutura de objeto e pares de chave-valor abaixo:

Por exemplo, um JSON que fornece o nome do país e a moeda local com base na abreviação do país

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Você também pode usar o editor da UI para definir a estrutura JSON.


Vá para Conteúdo > Tabelas de Pesquisa e clique em Criar.

  • Insira um nome de exibição

  • Insira um slug sem espaços



O Slug é usado para referenciar esta tabela e pode conter apenas caracteres alfanuméricos. Observe que esse slug é usado para referenciar o modelo de email

  • Clique em Salvar



Criando um item em uma tabela

Clique na tabela que você criou

Do menu de contexto que aparece, selecione "Visualizar"



Cada item em uma tabela é essencialmente um documento JSON. Isso significa que você pode construir uma estrutura de árvore de chaves e valores, onde os valores podem ser texto, números, booleanos, arrays ou objetos. Você pode inserir um documento JSON diretamente, usando a sintaxe JSON ou pode usar um editor de interface para construir o documento JSON.

Editor JSON

  • Depois de salvar, você verá um editor JSON. Você pode selecionar o editor de Texto ou o editor da UI de acordo com sua preferência.

  • Atualize a tabela de pesquisa usando uma estrutura JSON.

Adicionando um item

Para adicionar um item em um JSON para organização, clique em +Adicionar Item no painel esquerdo.

  • Digite um nome no topo

  • Clique no botão Adicionar Item

  • Uma vez criado, você pode ver o item criado no painel esquerdo.

Escreva o JSON

Use o formato JSON para definir qualquer estrutura de objeto e pares de chave-valor abaixo:

Por exemplo, um JSON que fornece o nome do país e a moeda local com base na abreviação do país

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Você também pode usar o editor da UI para definir a estrutura JSON.


Use a Tabela de Consulta no Modelo de E-mail


Para usar uma tabela de consulta em um modelo de email, você pode adicionar a seguinte sintaxe líquida ao seu modelo HTML ou a um elemento HTML usado em um construtor de arrastar e soltar:

{% assign variable_name = "lookup-table-slug" | lookup: "item-name", "object-value" %}

{{variable_name.key_name}}
{% assign variable_name = "lookup-table-slug" | lookup: "item-name", "object-value" %}

{{variable_name.key_name}}
{% assign variable_name = "lookup-table-slug" | lookup: "item-name", "object-value" %}

{{variable_name.key_name}}

Aqui,

  • variable_name é qualquer nome que você pode definir

  • lookup-table-slug é o slug que você deu ao criar a tabela de consulta

  • item-name é o nome do item que você criou

  • object-value é o valor que você definiu para o item JSON

  • key_name é o nome da chave no par chave-valor definido sob item-value

Por exemplo,

Para renderizar a moeda local de um país definido, podemos usar a sintaxe abaixo

  • variable_name aqui é definido como moeda (qualquer nome que o usuário pode definir)

  • lookup-table-slug aqui é country-flags como definido quando a tabela de consulta foi criada

  • item-name é o país conforme criado anteriormente e mostrado no painel esquerdo

  • object-value é AD, que é o valor definido no JSON. Observe que isso também pode ser uma variável

  • key_name é a local_currency, que é definida no JSON

{% assign currency = "country-flags" | lookup: "country", "AD" %}

{{currency.local_currency}}
{% assign currency = "country-flags" | lookup: "country", "AD" %}

{{currency.local_currency}}
{% assign currency = "country-flags" | lookup: "country", "AD" %}

{{currency.local_currency}}

Quando usado no construtor de modelos de email em um bloco HTML, a sintaxe acima renderizará o valor da local_currency conforme armazenado sob o objeto AD no item país na tabela de consulta country-flags

Você pode mudar para a seção de visualização para ver o valor exibido dinamicamente no modelo de email. Abaixo, está mostrando EUR como o valor buscado na tabela de consulta.

Usando tabelas de consulta em Fluxos

Você pode ler tabelas de consulta em Fluxos para reutilizar dados definidos centralmente.

Para usar uma tabela de consulta, primeiro crie uma conforme descrito acima.

  1. Navegue até Workflows > Fluxos

  2. Crie um fluxo inicial usando um tipo de gatilho de sua escolha.

Adicione um novo Realizar Consulta ao seu fluxo. Clique em Adicionar Nova Ação e selecione-o no grupo Tabelas de Consulta ou pesquise por ele usando a capacidade de Pesquisa à direita:



Você verá uma tela de configuração onde pode selecionar a tabela da qual ler e configurar exatamente como deseja realizar essa consulta:



Você verá três componentes que pode configurar:

  1. Slug da Tabela de Consulta indica qual tabela você deseja consultar. Ao clicar neste campo, o Fluxos mostrará as tabelas de consulta disponíveis:

  1. Consulta permite que você determine o que recuperar e você pode usar as várias variáveis disponíveis para construir essa chave de consulta. A operação padrão é retornar o valor para o qual você consulta como o valor de nível raiz, mas se você quiser criar um objeto de dados, pode usar a capacidade Como para carregá-lo em uma propriedade específica:

  1. Substituir permite que você substitua variáveis nos resultados de consulta retornados por um valor estático ou um valor que é definido em algum lugar em sua tabela de consulta. O seguinte exemplo substituiria o texto {{ MyVariableName }} em qualquer item retornado com a ação de Consulta pelo valor que encontra sob a chave replacements.<locale>.MyVariableName:

Ao clicar no botão Testar, você poderá ver os dados resultantes:


Configurar qual tabela ler é necessário e você deve adicionar pelo menos uma ação Consulta. Você não é obrigado a adicionar ações Substituir.


A person is standing at a desk while typing on a laptop.

A plataforma completa nativa de IA que escalará com o seu negócio.

© 2026 Pássaro

A person is standing at a desk while typing on a laptop.

A plataforma completa nativa de IA que escalará com o seu negócio.

© 2026 Pássaro