> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.2/wedocs-5.1/cliente-desktop/cadastro-de-tarefas-e-alertas/uso-de-variaveis-dinamicas-nos-campos-dos-gatilhos.md).

# Uso de Variáveis Dinâmicas nos Campos dos Gatilhos

Na configuração de tarefas automatizadas, é possível utilizar variáveis dinâmicas para inserir informações dos registros diretamente nas ações da tarefa, como no envio de e-mails.

As variáveis dos **Campos dos gatilhos** utilizam a sintaxe `triggerField` e são reconhecidas pelo sistema independentemente do uso de letras maiúsculas ou minúsculas. Dessa forma, a escrita da variável não interfere no seu funcionamento.

<div align="left"><figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FCtkp6TEkFvBOdF8j3UZM%2Fimage.png?alt=media&amp;token=ea6cf89f-916f-478e-b024-584665637d69" alt="" width="563"><figcaption></figcaption></figure></div>

#### Exemplos de sintaxe válida

As opções abaixo possuem o mesmo comportamento e podem ser utilizadas normalmente:

* `%triggerField:1%`
* `%TriggerField:1%`
* `%triggerfield:1%`
* `%TRIGGERFIELD:1%`

### Como utilizar as variáveis dos Campos dos gatilhos

Para que as variáveis estejam disponíveis nas ações da tarefa, é necessário que o **metadado esteja configurado no gatilho**. Após essa configuração, os campos passam a ser disponibilizados automaticamente para uso nas ações.

<div align="left"><figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FY0RbBC5yaHs0N2jsPJsK%2Fimage.png?alt=media&amp;token=cfb45926-f00b-4088-8d66-9ba976925eb4" alt="" width="563"><figcaption></figcaption></figure></div>

#### Configuração do gatilho

1. Acesse o **Cadastro de tarefas**.
2. Selecione a aba **Gatilhos** e clique em **Adicionar**.
3. Selecione a aba **Condição .**&#x20;
4. Escolha o modo **Metadado**.
5. Selecione o metadado desejado e clique em **Configurar**.
6. Defina os campos que deverão ser considerados no gatilho.

Os campos selecionados serão utilizados como base para a criação das variáveis dinâmicas.

#### Exemplo de utilização: envio de e-mail com dados do gatilho

Em uma tarefa que possui uma ação de **envio de e-mail**, é possível utilizar as variáveis dos Campos dos gatilhos para compor dinamicamente o assunto e o conteúdo da mensagem.

Por exemplo, ao configurar um gatilho baseado em um metadado que contém os campos **Categoria** e **Produto**, esses campos ficam disponíveis como variáveis na ação de envio de e-mail.

No momento da execução da tarefa, o sistema substitui automaticamente as variáveis pelos valores correspondentes aos dados do registro que acionou o gatilho.

Esse mesmo conceito pode ser aplicado a qualquer outro campo configurado no gatilho, permitindo que as mensagens sejam personalizadas de acordo com as informações de cada execução.&#x20;

<div align="left"><figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FUb6q78nSfOAovn6o76zk%2Fimage.png?alt=media&amp;token=621ed72b-378a-400b-9da2-784e5e38fdc3" alt="" width="563"><figcaption></figcaption></figure></div>
