> 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/criacao-de-tarefas-e-alertas.md).

# Criação de Tarefas e Alertas

Weknow Client Desktop – Criação de Tarefas e Alertas - Criação de Tarefas

Para acessar esse recurso, seu usuário deve ter o papel de desenvolvedor ou administrador do Weknow. Se seu usuário estiver configurado com um destes papéis será possível acessar o menu: *<mark style="color:blue;">**Ferramentas > Gerenciar tarefas > Cadastro de tarefas**</mark>**.***

Nesse recurso, você pode cadastrar tarefas, configurar condições de monitoramento e definir ações para execução no Weknow:

### Cadastro de Tarefas >  Geral

<figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FgmkXRmIXyRwaFRusqqau%2Fimage.png?alt=media&amp;token=cd9b33d4-7e49-48c1-b3b0-26b54348c21f" alt=""><figcaption></figcaption></figure>

* Dê Enter no campo *<mark style="color:blue;">Código</mark>* ou clicar no botão com *\**;
* Informe uma *<mark style="color:blue;">Descrição</mark>* e uma *Documentação* para identificar a tarefa;
* Indique a *<mark style="color:blue;">Frequência</mark>* em que será definida a periodicidade de monitoramento da tarefa.&#x20;

{% hint style="info" %}
**Importante:** A frequência configurada em **Cadastro de Tarefas > Geral** influencia o envio de notificações para um mesmo destinatário, incluindo mensagens enviadas por e-mail, Telegram e WhatsApp.

As opções de frequência determinam como os envios são controlados:

* **Sempre:** permite o envio de todas as notificações geradas, sem limitar os envios por um intervalo de tempo.
* **Uma vez por:** permite o envio de uma notificação por período configurado. Por exemplo, ao selecionar *Uma vez por dia*, se o destinatário receber uma notificação às 23h, poderá receber outra a partir das 00h do dia seguinte.
* **A cada:** estabelece um intervalo mínimo entre dois envios para o mesmo destinatário. Por exemplo, ao selecionar *A cada 1 dia*, deve haver um intervalo mínimo de 24 horas entre os envios.

Essa configuração é especialmente importante quando diferentes registros utilizam o mesmo endereço de e-mail ou outro contato como destinatário, pois a frequência selecionada pode limitar o envio de notificações para esse destino.
{% endhint %}

* Indique se a tarefa já deverá estar *<mark style="color:blue;">Ativada</mark>* ao final de seu cadastro ou deixe este campo desmarcado se a mesma deve ficar temporariamente desativada;
* Ao selecionar Executar Agora, a tarefa será executada imediatamente após o cadastro, independentemente do horário definido para sua execução.

***

### Cadastro de Tarefas > Gatilhos

Através desta aba, configure as condições para execução da tarefa.

<figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FU1rftJLptdraDHD8svCF%2Fimage.png?alt=media&amp;token=bf92feda-48c1-4ad4-8c49-1064d23a8154" alt=""><figcaption></figcaption></figure>

* &#x20;Clique em *<mark style="color:blue;">Adicionar</mark>* para incluir as regras de agenda aplicadas às ações desta tarefa, ou seja, em que momento serão executadas.

***

### Cadastro de Tarefas > Gatilhos > Adicionar > Agenda

<figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2F1F6fK8JYKX6OLeJs0YdM%2Fimage.png?alt=media&amp;token=4282f8eb-d639-4551-a0ce-7e4c93fea416" alt=""><figcaption></figcaption></figure>

Nesta aba, configure o período de vigência e a periodicidade de execução do gatilho.

* **Data inicial e Data final:** definem o período de vigência da agenda.
* **Frequência:** define a periodicidade da agenda, com opções diárias, semanais ou mensais.
* **Executar uma vez neste horário:** permite definir um horário específico para a execução.
* **Executar a cada:** permite configurar execuções em intervalos, conforme as opções disponíveis.
* **Primeiro horário para execução e Último horário para execução:** delimitam o intervalo de horários em que as execuções poderão ocorrer, conforme a configuração selecionada.

{% hint style="warning" %}
**Importante:** A frequência configurada nesta aba determina quando o gatilho será executado, conforme a agenda definida. Já a frequência configurada em **Cadastro de Tarefas > Geral** controla a periodicidade de monitoramento da tarefa e pode limitar os envios de notificações para um mesmo destinatário, inclusive por e-mail, Telegram ou WhatsApp.

Essas configurações têm finalidades diferentes e devem ser consideradas separadamente.
{% endhint %}

***

### ***Cadastro de Tarefas > Gatilhos > Adicionar > Condição***

<figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FutUH9PBpq6MzalJTmBFP%2Fimage.png?alt=media&amp;token=392c6067-0b1c-4d0e-bb89-daa574601454" alt=""><figcaption></figcaption></figure>

Nas situações em que, além de uma regra de agendamento, se faz necessária a verificação de determinada condição, é possível configurá-la através desta aba.

No campo *<mark style="color:blue;">Modo</mark>*, selecione a forma como será monitorado este complemento;

*<mark style="color:blue;">Nenhum</mark>* – o Weknow irá obedecer ao que foi definido na aba: Agenda;

*<mark style="color:blue;">SQL</mark>*: além das regras definidas na agenda, permite verificar uma condição com base em uma informação retornada por um código SQL

No campo *<mark style="color:blue;">Conexão</mark>* indique aquela onde o código deverá ser executado;

Em *<mark style="color:blue;">Código SQL</mark>* insira o código SQL que retorne a informação utilizada na verificação da condição. Por exemplo, um código que verifique se determinado valor no faturamento foi atingido.\
Nesta situação, com o horário (agenda) e condição informados, o gatilho será disparado.

*<mark style="color:blue;">Metadado</mark>* – através deste Modo você pode utilizar um código já existente, e filtrar seu conjunto de dados para análise de disparo ou não da tarefa em questão.

&#x20;Clique em *OK* para concluir o cadastro deste gatilho dentro de sua tarefa.

***

### Cadastro de Tarefas > Ações

Através desta aba configure as Ações que serão executadas nesta Tarefa quando as condições definidas em Gatilhos forem atingidas.

<figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2F2ucRDAHzbI4rmzThaYKo%2Fimage.png?alt=media&amp;token=595028ba-0495-4539-bc71-22c05adbe6f8" alt=""><figcaption></figcaption></figure>

Clique em *<mark style="color:blue;">Adicionar</mark>* e selecione uma das opções disponíveis (imagem acima) para realizar sua configuração de acordo com as necessidades a serem aplicadas na tarefa. Uma tarefa pode ter mais de uma ação configurada.\
Ao clicar sobre uma ação, serão visualizadas as respectivas telas com suas configurações específicas:

* [<mark style="color:blue;">**Enviar e-mail**</mark>](/wedocs-5.2/wedocs-5.1/cliente-desktop/cadastro-de-tarefas-e-alertas/enviar-e-mail.md)
* [<mark style="color:blue;">**Enviar SMS**</mark>](/wedocs-5.2/wedocs-5.1/cliente-desktop/cadastro-de-tarefas-e-alertas/enviar-sms.md)
* [<mark style="color:blue;">**Exportar arquivo**</mark>](/wedocs-5.2/wedocs-5.1/cliente-desktop/cadastro-de-tarefas-e-alertas/exportar-arquivo.md)
* [<mark style="color:blue;">**Executar stored procedure**</mark>](/wedocs-5.2/wedocs-5.1/cliente-desktop/cadastro-de-tarefas-e-alertas/executar-stored-procedure.md)
* [<mark style="color:blue;">**Abrir/executar arquivo**</mark>](/wedocs-5.2/wedocs-5.1/cliente-desktop/cadastro-de-tarefas-e-alertas/abrir-e-executar-arquivo.md)
* [<mark style="color:blue;">**Enviar Telegram**</mark>](/wedocs-5.2/wedocs-5.1/cliente-desktop/cadastro-de-tarefas-e-alertas/enviar-telegram.md)
* [<mark style="color:blue;">**Enviar WhatsApp**</mark>](/wedocs-5.2/wedocs-5.1/cliente-desktop/cadastro-de-tarefas-e-alertas/enviar-whatsapp.md)
* [Exportar Conteúdo do Sistema](/wedocs-5.2/wedocs-5.1/cliente-desktop/cadastro-de-tarefas-e-alertas/exportar-conteudo-do-sistema.md)

***

### Executar uma tarefa no Weknow Web

Para executar, basta seguir os passos:

**Weknow Web >  Página inicial > Tarefas > Executar:**