> 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/weknow-client/cadastro-de-tarefas-e-alertas/enviar-e-mail.md).

# Enviar E-mail

Utilizando esta opção é possível enviar e-mails com sequências de dashboards ou anexos contendo resultados de consultas obtidas através de um metadado e os seus respectivos campos selecionados.

***

### Tarefa: Enviar E-mail - Configurando dados iniciais

***Cadastro de Tarefas > Ações > Adicionar > Enviar e-mail > Geral***

<div align="center"><figure><img src="https://content.gitbook.com/content/e85p03cLIYvL7gAVHE90/blobs/LDigVepxDzZanB774v8o/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

* &#x20;Em *<mark style="color:blue;">Assunto</mark>*, indique o título do e-mail;
* &#x20;Em *<mark style="color:blue;">Mensagem</mark>*, se desejar, insira uma descrição que irá aparecer no corpo do e-mail.

&#x20;<mark style="color:blue;">**Para que o Destinatário visualize Anexos ao Corpo do E-mail**</mark>**:**

Informe o *<mark style="color:blue;">Nome</mark>* cadastrado para cada anexo configurado na aba: *Anexos* utilizando o símbolo de **%** no início e fim de cada um dos itens a serem inseridos no corpo do e-mail.

Exemplo:

%Anexo\_01%\
%Anexo\_02%\
%Anexo\_03%

*<mark style="color:blue;">Os anexos que não forem mencionados desta forma no campo mensagem, não deixarão de estar na área de anexos do e-mail</mark><mark style="color:orange;">.</mark>*

***

### Enviar E-mail - Inserindo Anexos

Através desta aba é possível incluir tipos de anexos como dashboards, imagens, determinadas informações obtidas nas consultas de metadados e arquivos diversos.

***Cadastro de Tarefas > Ações > Adicionar > Enviar e-mail > Anexos***

<div align="center"><figure><img src="https://content.gitbook.com/content/e85p03cLIYvL7gAVHE90/blobs/zhoem4sAhztMsKzKOYJz/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

* &#x20;Em *<mark style="color:blue;">Nome</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">e</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Descrição</mark>* insira as informações de identificação do anexo.\
  *\*O nome deverá ser inserido sem espaços para que o botão OK fique habilitado.*
* &#x20;No campo *<mark style="color:blue;">Conteúdo</mark>* defina o tipo de anexo a ser inserido no e-mail/alerta:\
  *\*É possível inserir vários anexos do mesmo tipo ou até diferentes tipos.*<br>

***

### Enviar E-mail - Tipos de Anexos a serem inseridos

***Cadastro de Tarefas > Ações > Adicionar > Enviar e-mail > Anexos > Conteúdo***

* &#x20;<mark style="color:blue;">**Dashboard**</mark>: Possibilita escolher através de uma lista os dashboards já cadastrados no Weknow;
* &#x20;<mark style="color:blue;">**Arquivo**</mark>: Arquivos em geral;
* &#x20;<mark style="color:blue;">**Componente**</mark>: Item isolado existente dentro de um dashboard cadastrado no Weknow;
* <mark style="color:blue;">**Metadado**</mark>: Listagem/resultado de uma consulta executada dentro de um metadado;

***

### Enviar E-mail - Inserindo um Anexo do tipo Dashboard

***Cadastro de Tarefas > Ações > Adicionar > Enviar e-mail > Anexos > Conteúdo > Dashboard***

É possível enviar **anexos em formato PDF** nos e-mails automáticos configurados nas tarefas do sistema.

<div align="center"><figure><img src="https://content.gitbook.com/content/e85p03cLIYvL7gAVHE90/blobs/xBmtu5Xdr8yveXrN6xVB/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

Ao configurar anexos do tipo **Dashboard**, os formatos:

* BMP,
* PNG,
* JPG e
* **PDF.**

Com isso, os dashboards podem ser exportados em um formato mais adequado para visualização, impressão e distribuição.

***

### Enviar E-mail - Inserindo um Anexo do tipo Metadado

***Cadastro de Tarefas > Ações > Adicionar > Enviar e-mail > Anexos > Conteúdo > Metadado***

Ao selecionar o tipo de conteúdo como ***Metadado***, escolha um dos metadados já cadastrados no Weknow ou crie um novo.

Selecionando um metadado, agora será necessário clicar sobre o botão *Configurar* para inserir os campos/informações que deverão conter no anexo.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2Fujg5mKTcDezpwpZPEEw8%2Fimage.png?alt=media&amp;token=debce7e5-1074-48d9-9c59-91394e096455" alt=""><figcaption></figcaption></figure>

Na janela que será aberta, em uma lista à esquerda da tela encontram-se os *<mark style="color:blue;">Campos</mark>* do *<mark style="color:blue;">Metadado</mark>* indicado. Estes campos poderão ser alocados como campos do anexo, filtros, ou ordenação, bastando arrastá-los com o mouse para a área ao centro da tela:

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FkTBYlDgj0eUcx60wmBgL%2Fimage.png?alt=media&amp;token=8c268d62-2003-4f27-bd25-482d977261a6" alt=""><figcaption></figcaption></figure>

Ao lado de cada campo selecionado existem opções para aplicar funções de agregação entre os campos, ou seja, além de apresentar os dados obtidos através do metadado será possível aplicar a visualização de outros resultados utilizando estas funções.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FSL5Ctfhnr94NT0uGw9SY%2Fimage.png?alt=media&amp;token=d4b8ef77-038a-49b7-ae36-26b4cbd181c0" alt=""><figcaption></figcaption></figure>

*<mark style="color:blue;">Ordenação:</mark>* desejando que haja ordenação na visualização do metadado, selecione o(s) arrastando os campos(s) da lista a esquerda, para a área de ordenação, para que as regras sejam aplicadas;&#x20;

Também poderão ser inseridos <mark style="color:blue;">Filtros</mark> através das áreas *<mark style="color:blue;">Filtros (por registro)</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">e</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Filtros agrupados</mark>* da mesma forma como são aplicados na edição dos componentes visuais.

Na inserção de Anexo do tipo *<mark style="color:blue;">Metadado</mark>*, opção na tela: *<mark style="color:blue;">Assistentes</mark>* ainda será possível definir em que formato o arquivo anexo deverá ser enviado e definir outras configurações de visualização do mesmo:

*Exemplo:*\
Aplicação do formato *<mark style="color:blue;">Tabela HTML</mark>* através da opção *<mark style="color:blue;">Assistentes</mark>* da tela *<mark style="color:blue;">Anexos do E-mail > tipo: Metadado.</mark>*

Para cada formato será aberta uma tela com diversas opções para personalizar a visualização do metadado a ser anexado. Ao selecionar Tabela HTML serão abertas configurações da Tabela, como tipo de Fonte, Margens, Bordas, Linhas e das Colunas.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FcFAExqgcymhxICH48FlO%2Fimage.png?alt=media&amp;token=d8c886ec-d5b6-4f19-b9f3-61f6fee7ee21" alt=""><figcaption></figcaption></figure>

Utilize o botão *<mark style="color:blue;">Amostra</mark>* para obter uma prévia das formatações realizadas até o momento.

Para confirmar as alterações clique em *<mark style="color:blue;">Ok</mark>*;

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FZyQRmSemHAYhG11JrUEF%2Fimage.png?alt=media&amp;token=e0eb1fc4-6e0c-4846-9d84-6e7b539d8dcf" alt=""><figcaption></figcaption></figure>

***

### Enviar E-mail – Configurando os Destinatários

***Cadastro de Tarefas > Ações > Adicionar > Enviar e-mail > Destinatários***

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FyUf9mVfVwV1uRuDxonXm%2Fimage.png?alt=media&amp;token=6f3c4f2b-d05f-4ce2-a8c5-6d25e6441bf8" alt=""><figcaption></figcaption></figure>

***Cadastro de Tarefas > Ações > Adicionar > Enviar e-mail > Destinatários > Adicionar > Destinatários***

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2Fo9hJecoPdQWysJGFXwQF%2Fimage.png?alt=media&amp;token=95c8af0a-c892-4c6f-8337-f6098d789f7a" alt=""><figcaption></figcaption></figure>

*<mark style="color:blue;">**Endereços:**</mark>* Neste campo, você pode informar endereços de e-mail que não estejam cadastrados nos contatos do Weknow.\
\* *Utilize “**;***” *como separador para os endereços de e-mail incluídos neste campo.*

\
*<mark style="color:blue;">**Contatos**</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">e</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">**Grupos de Contatos:**</mark> I*nclua destinatários já cadastrados no Weknow através do menu de *Administração > Contatos e usuários*

*\*Estas opções podem ser utilizadas em paralelo, ou seja, é possível inserir destinatários no campo Endereços, Contatos e Grupos de Contatos em um único cadastro.*

*É possível também incluir destinatários através de uma lista obtida via SQL, para tanto:*

*<mark style="color:blue;">**Conexão:**</mark>* Selecione uma das suas conexões já pré-estabelecidas

*<mark style="color:blue;">**Código SQL:**</mark>* Insira o código SQL que buscará as informações dos destinatários

*<mark style="color:blue;">**Campo Nome:**</mark>* Informe neste campo o nome da coluna retornada pela consulta SQL que contém os dados do destinatário

*<mark style="color:blue;">**Campo Endereço:**</mark>* Copie e cole neste campo a parte do código SQL ao qual se refere ao resgate dos dados: Endereço de e-mail do(s) destinatário(s);

{% hint style="warning" %}
**Importante:** A frequência configurada em **Cadastro de Tarefas > Geral** influencia o envio de notificações para um mesmo destinatário. Dependendo da opção selecionada, o sistema poderá limitar os envios mesmo quando diferentes registros atenderem às condições do gatilho.

* **Sempre:** permite o envio de todas as notificações geradas.
* **Uma vez por:** limita o envio a uma notificação por período configurado.
* **A cada:** estabelece um intervalo mínimo entre dois envios para o mesmo destinatário.

Se diferentes registros utilizarem o mesmo endereço de e-mail como destinatário, verifique a frequência configurada na tarefa. Para entender o funcionamento dessas opções, consulte o artigo **Criação de Tarefas e Alertas**.
{% endhint %}

***

### Enviar E-mail – Configurando o Remetente

***Cadastro de Tarefas > Ações > Adicionar > Enviar e-mail > SMTP***

Através desta aba informe o remetente que encaminhará o e-mail.

*<mark style="color:blue;">**Campo: Servidor**</mark>*

*<mark style="color:blue;">**Utilizar o padrão:**</mark>* Conforme dados definidos como padrão através do menu:\
*Administração > Cadastro de Servidores SMTP*

*<mark style="color:blue;">**Selecionar:**</mark>* Escolher de uma lista de servidores SMTP já cadastradas através do menu: *Administração > Cadastro de Servidores SMTP*

*<mark style="color:blue;">**Definir manualmente:**</mark>* Informar através dos campos apresentados na tela as configurações de um novo SMTP para envio dos e-mails:

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FDrs1L1UYirPV5glDoJwC%2Fimage.png?alt=media&amp;token=42f04a2c-c46b-46e3-81fc-789e1fb290c6" alt=""><figcaption></figcaption></figure>

***

### Tarefa: Enviar E-mail – Finalização e Edição

Após definição de todos os detalhes para o envio de e-mail, clique em OK e então, na aba *Ações* desta tarefa irá aparecer o registro referente às configurações realizadas.

Para fazer alguma alteração clique duas vezes sobre a descrição do registro, que então irá abrir a tela de configurações para o envio de e-mail.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FMAe4tfd0garNUyRCOUTU%2Fimage.png?alt=media&amp;token=e2c5102d-98fc-4a27-b72c-cfb341485f2a" alt=""><figcaption></figcaption></figure>