# Criação e Configuração de Gatilhos no Orquestrador

Os Gatilhos são necessários para criar Trabalhos automaticamente com base em condições específicas. Os Trabalhos criados são então enviados para os Robôs para processamento.

Para criar um novo Gatilho no Orquestrador, acesse a tela “Gatilhos”. Esta tela contém a tabela “Gatilhos”:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-d721a4ab111c0c8a35b2c71114695d2e37483f16%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(270).png?alt=media" alt=""><figcaption></figcaption></figure>

Para trabalhar com Gatilhos na tela, existem os seguintes botões:

<table><thead><tr><th width="175">Nome</th><th>Descrição</th></tr></thead><tbody><tr><td>Criar</td><td>Permite ao usuário criar um novo Gatilho. Ao clicar, abre um formulário para inserir os dados necessários e configurar os parâmetros do novo Gatilho.</td></tr><tr><td>Atualizar</td><td>Permite atualizar as informações sobre o Gatilho selecionado.</td></tr><tr><td>Excluir selecionado</td><td>Permite excluir um ou mais Gatilhos selecionados.</td></tr><tr><td>Ativar selecionado</td><td>Ativa os Gatilhos selecionados, permitindo que comecem a funcionar no sistema.</td></tr><tr><td>Desativar selecionado</td><td>Desativa os Gatilhos selecionados, interrompendo sua execução e desabilitando suas funções.</td></tr><tr><td>Testar</td><td>Permite testar o Gatilho selecionado. Isso ajuda a garantir que o Gatilho funcione corretamente e execute as ações programadas.</td></tr><tr><td>Importar de CSV</td><td>Permite ao usuário carregar dados sobre Gatilhos de um arquivo no formato CSV. Ao selecionar esta opção, abre uma janela de diálogo para carregar o arquivo com os dados necessários.</td></tr><tr><td>Exportar para CSV</td><td>Permite salvar informações sobre Gatilhos no formato CSV.</td></tr><tr><td>Exportar para XLSX</td><td>Permite exportar dados sobre Gatilhos no formato XLSX.</td></tr></tbody></table>

## Botão "Criar"

Para criar um novo Gatilho, clique no botão “Criar” acima da tabela “Gatilhos” e preencha o formulário que se abre. Para conveniência, a configuração dos Gatilhos é dividida em várias abas:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-b0157d885b1fdee3849ec5ca8d5b88eb64e8d76c%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(271).png?alt=media" alt=""><figcaption></figcaption></figure>

* “**Principais**”. Dados principais do Gatilho;
* “**Robôs**”. Seleção do Robô ou Grupo de robôs para o trabalho, ao qual o Trabalho será atribuído após a ativação do Gatilho;
* “**Programação**”. Programação pela qual o Gatilho será ativado. As seguintes opções de programação estão disponíveis: “Processar continuamente”, “Processar conforme programação”, “Último dia do mês”, “N-ésimo dia do mês”;
* “**Fila**”. Configuração da criação de Trabalhos ao surgirem novas Tarefas na Fila;
* “**Email**”. Configuração do Gatilho com condições específicas para a criação de Trabalhos relacionados ao processamento de e-mails.

Vamos examinar cada uma das abas em mais detalhes.

### Aba "Principais"

Na aba “Principais”, preencha os seguintes campos:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-2b6031a1a1edab7fb0e8ccf6488b520946a1a003%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(543).png?alt=media" alt=""><figcaption></figcaption></figure>

* campo “**Nome**”. Campo obrigatório para preenchimento com o nome do Gatilho;
* campo “**Descrição**”. Descrição do Gatilho, se necessário;
* campo “**Prioridade dos Trabalhos criados**“. Escolha a ordem de execução dos Trabalhos.
* campo “**Pasta de acesso**”. Selecione a Pasta de acesso na lista suspensa;
* campo “**Processo**”. Selecione o Processo que será iniciado quando o Gatilho for ativado (o Processo pode ser escolhido apenas entre os já criados na tela “Processos”). Campo obrigatório para preenchimento;
* campo “**Máx. número de execuções**”. Indique o número máximo de execuções do Gatilho. Se não houver restrições, coloque `0` neste campo;
* interruptor “**Ativado**”. Ative o interruptor se for necessário que o Gatilho esteja ativado imediatamente após sua criação;
* caixa de seleção “**Se todos os robôs estiverem ocupados, criar trabalho após sua liberação**”. Marque se for necessário que um Trabalho seja criado após a liberação dos Robôs;

### Aba "Robôs"

Na aba “Robôs”, forneça os seguintes dados:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-fd8f52182a49aae710bdadc2bd6275874302e466%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(274).png?alt=media" alt=""><figcaption></figcaption></figure>

* sinalizador “**Atribuir trabalho a um robô específico**”. Preencha se for necessário que o Trabalho seja executado por um Robô específico. No campo “**Robô**”, localizado abaixo, selecione o Robô desejado na lista suspensa;
* sinalizador “**Distribuir trabalho entre o grupo de robôs**”. Preencha se for necessário atribuir o Trabalho a um determinado Grupo de robôs. No campo “**Grupo de robôs**”, localizado abaixo, selecione o Grupo de robôs desejado na lista suspensa;
* campo “**Número máximo de robôs executando simultaneamente**”. Indique o número máximo de Robôs que estarão executando Trabalhos criados por este Gatilho.

Sinalizadores adicionais para preenchimento, caso todos os Robôs no Grupo especificado estejam ocupados:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-ecc4c5f9238c1b6ecea537f82aea7b80cbb8b02e%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(275).png?alt=media" alt=""><figcaption></figcaption></figure>

* sinalizador “**Criar trabalho sem robô previamente atribuído. Assim que qualquer robô do grupo se liberar, o trabalho será automaticamente atribuído a ele**”;
* sinalizador “**Criar trabalho para um robô do grupo que ainda está ocupado, que tem o menor número de trabalhos em status Pending**".

### Aba "Programação"

A aba “Programação” apresenta diferentes opções, dependendo da opção de programação que você escolher:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-9b3e70fdc88fede57b2b51b6fed587e3cd4393cd%2F2025-04-16_14-49-58.png?alt=media" alt=""><figcaption></figcaption></figure>

#### <mark style="color:red;">Processar continuamente</mark>

Escolha a opção “Processar continuamente” se for necessário que os Trabalhos sejam realizados continuamente, levando em consideração as restrições definidas nas outras abas. No formulário, forneça os seguintes dados:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-b9510ad0c243d2242bcd10390d4957a2e3dcf2ff%2F2025-04-16_14-56-05.png?alt=media" alt=""><figcaption></figcaption></figure>

* campo “**Exceto feriados conforme calendário:**”. Use a lista suspensa para escolher o calendário desejado entre os já criados na tela “Recursos”;
* campo “**Parar trabalho após o intervalo de tempo especificado após sua criação**”. Indique a duração máxima do trabalho no formato horas:minutos até a “parada suave”;
* campo “**Interromper trabalho após o intervalo de tempo especificado após sua criação**”. Indique a duração máxima do trabalho no formato horas:minutos até a “parada rígida”;
* campos “**A programação é válida de**” e “**A programação é válida até**”. Indique a data e hora no formato DD.MM.AAAA horas:minutos:segundos (de quando e até quando, respectivamente, a programação será válida).

#### <mark style="color:red;">Processar conforme programação</mark>

Escolha a opção “Processar conforme programação” se for necessário que os Trabalhos sejam realizados de acordo com uma programação estabelecida. Este formulário é praticamente idêntico à opção “Processar continuamente”, exceto pelos seguintes elementos:

* interruptor “**Usar expressão Cron**”. Clique se for necessário definir a programação para a ativação do Gatilho diretamente;

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-bc783f73defd8bf0bee2a38a6838c9877c7111ab%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(277).png?alt=media" alt=""><figcaption></figcaption></figure>

* lista “**Every**”. Selecione a opção desejada para definir a programação do Gatilho.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-de8831e5b6f3289447c5bfc05c0913a05ddb31a6%2F2025-04-16_15-19-49.png?alt=media" alt=""><figcaption></figcaption></figure>

#### <mark style="color:red;">Último dia do mês</mark>

Escolha a opção “Último dia do mês” se for necessário que os Trabalhos sejam realizados no último dia do mês. Este formulário é praticamente idêntico à opção “Processar continuamente”, exceto pelo campo com a lista suspensa: ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-dc36129cf54cb0e5343cbdd5dc813198375e50c2%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(265\).png?alt=media), que deve ser usado para definir a programação do Gatilho.

#### <mark style="color:red;">Cada N-ésimo dia do mês</mark>Escolha a opção “Cada N-ésimo dia do mês” se for necessário que as Tarefas sejam realizadas a cada N-ésimo dia do mês. Este formulário é praticamente idêntico à opção “Último dia do mês”, exceto pelo campo ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-7da50e176753a128a3fc58dbc6b8ebc3929e18bf%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(267\).png?alt=media), onde é necessário inserir o número desejado manualmente no teclado ou com a ajuda do contador pop-up ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-59fe1227a28513e77e8de217b4ba955fe126981f%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(268\).png?alt=media).

### Aba "Fila"

Na aba “Fila”, forneça os seguintes dados:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-aef3cf0f378430a07aa06a0dc6759c193a30cb1c%2F2025-04-16_15-33-59.png?alt=media" alt=""><figcaption></figcaption></figure>

* flag “**Criar tarefas ao surgirem novas tarefas na fila**”. Preencha para ativar a função de criação de Tarefas ao surgirem novas tarefas na Fila;
* campo “**Fila**”. Use a lista suspensa para selecionar uma Fila específica entre as anteriormente criadas na tela “Fila”;
* campo "**Considerar apenas tarefas que estão marcadas com todas as tags listadas ao mesmo tempo**". Indique as tags que as tarefas devem ter;
* campo “**Iniciar quando houver mais novas tarefas do que**”. Indique a quantidade de novas tarefas na Fila após a qual o Robô será iniciado;
* campo “**Definir status da tarefa recebida da fila**”. Use a lista suspensa para indicar o status da tarefa, escolhendo entre as opções disponíveis: “Criado” ou “Em andamento”;
* checkbox “**Concluir quando a fila estiver vazia**”. Marque se for necessário concluir o Gatilho na ausência de tarefas na Fila. Nesse caso, o Gatilho terá o status “Concluído”;
* flag “**Atribuir tarefa padrão às tarefas criadas**”. Preencha se for necessário vincular o Gatilho a uma tarefa específica e usar essa tarefa como padrão ao criar Tarefas pelo Gatilho;
* campo “**Tarefa**”. Use a lista suspensa para selecionar uma tarefa específica entre as anteriormente criadas na tela “Fila”.

### Aba "Email"

Na aba “Email”, forneça os seguintes dados:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-410d40c862483995d2b4e404ac9016fa8583ba32%2F2025-04-16_15-44-59.png?alt=media" alt=""><figcaption></figcaption></figure>

* checkbox “**Criar tarefa ao receber Email**”. Marque para criar uma Tarefa ao receber um e-mail;
* flag “**Protocolo**”. Selecione o protocolo de recebimento de e-mail entre as opções disponíveis: “POP3” e “IMAP”;
* flag “**Codificação do servidor**”. Selecione a opção de codificação entre as disponíveis: “UTF-8” e “US-ASCII”;
* campos “**Servidor de e-mail**” e “**Porta**”. Indique o servidor de e-mail e sua porta, respectivamente;
* campos “**Login**” e “**Senha**”. Indique o login e a senha de acesso ao serviço de e-mail;
* campo “**Nome da caixa de correio compartilhada**”. Indique o nome da caixa de correio compartilhada, que deve ser informado apenas quando vários Usuários têm acesso a uma única caixa de correio;
* campo “**Pasta**”. Indique a pasta na caixa de correio. Se a pasta não for especificada, a pasta “Entrada” será verificada por padrão;
* checkbox “**Usar SSL**”. Marque se for necessário usar SSL ao conectar-se ao servidor de e-mail;
* checkbox “**Processar apenas e-mails não lidos**”. Marque se for necessário processar apenas e-mails não lidos;
* checkbox “**Marcar como lido**”. Marque se for necessário que os e-mails pelos quais foram criadas Tarefas sejam marcados como “Lidos”;
* checkbox “**Criar uma tarefa ao surgirem novos e-mails / Criar uma tarefa para cada novo e-mail**”. Marque se for necessário criar uma Tarefa ao surgirem novos e-mails ou uma Tarefa separada para cada novo e-mail;
* campo “**Processar se o assunto do e-mail contiver qualquer uma das substrings especificadas**”. Indique as substrings que devem estar presentes no assunto do e-mail (ao indicar várias substrings, elas devem ser separadas por vírgulas), se necessário;
* campo “**Processar se o corpo do e-mail contiver qualquer uma das substrings especificadas**”. Indique as substrings que devem estar presentes no corpo do e-mail (ao indicar várias substrings, elas devem ser separadas por vírgulas), se necessário;
* campo “**Processar se o e-mail contiver anexos com qualquer um dos nomes de arquivos especificados**”. Indique os nomes dos arquivos que devem estar presentes nos anexos do e-mail (ao indicar vários nomes de arquivos, eles devem ser separados por vírgulas, e se necessário, podem ser usadas máscaras \* e ?), se necessário;
* campo “**Processar quando houver mais e-mails correspondentes do que**”. Indique a quantidade de e-mails após a qual o processamento será iniciado (verificação das condições do Gatilho e criação de Tarefas, se necessário);
* campo “**Verificar e-mail a cada N minutos**”. Indique o intervalo de tempo em minutos após o qual a verificação de e-mail no servidor será realizada e as Tarefas criadas, se necessário (se as condições do Gatilho acima forem atendidas).

Após preencher os campos, clique no botão “OK” para salvar o Gatilho.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-orchestrator/rabota-v-sherpa-orchestrator/nachalo-raboty-v-sherpa-orchestrator/sozdanie-i-nastroika-triggerov-v-orkestratore.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.