---
title: Criar um Ticket automaticamente a partir do Recebimento de um E-mail
slug: workflow/criar-um-ticket-automaticamente-a-partir-do-recebimento-de-um-e-mail
description: Learn how to automate ticket creation from emails with this detailed document. It provides step-by-step instructions for setting up an email account for IMAP access, configuring batch routines, and creating a ticket model. Increase efficiency by automatic
createdAt: 2021-10-28T17:33:36.000Z
---

Esta funcionalidade permite a criação automática de um ticket quando uma&#x20;mensagem de e-mail é enviada para um determinado endereço. Neste contexto, a&#x20;solução monitora constantemente a presença de mensagens na caixa de e-mail, e&#x20;caso alguma mensagem tenha o status não lida, esta será utilizada para registro&#x20;de um novo ticket.

Por exemplo, um usuário poderia solicitar determinado serviço enviando uma&#x20;mensagem para [servico@empresa.com](mailto\:servico@empresa.com). Após o recebimento do e-mail, a&#x20;funcionalidade, verificando que existe uma nova mensagem, registra um ticket&#x20;automaticamente. É importante destacar que após o registro do ticket, o e-mail é&#x20;marcado como lido.

Os tickets serão lidos de acordo com a pasta da caixa de entrada, que deve ser configurada, e quaisquer e-mails não lidos dentro dessa pasta serão utilizados para abertura do ticket. Também é possível mover um email não lido de outra pasta para a pasta configurada.

# Antes de começar

- [x] Configure  &#x20;uma conta de e-mail para permitir o acesso via IMAP previamente.&#x20;
- [x] Configure a instância para utilização de rotinas batch, uma vez que a  &#x20;verificação de e-mail é uma tarefa agendada.

# Procedimento

**Passo 1 - Crie um modelo de ticket**

Veja [Ação Automática via E-mail](docId\:ylSy6N7dIjlfcSV-7rrP6) e [Ação Automática de Incidentes/Requisições/Procedimentos](docId\:uDwuJOVA65HQHfDUvbnYI).

**Passo 2 - Configue acesso à bandeja de e-mails**

Crie ação automática de e-mail, este cadastro é usado&#x20;para disparar a leitura e o registro de solicitações.

**Passo 3 - Crie uma rotina de verificação (batch)**

Crie rotina batch, (veja Processamento Batch), do tipo "**Classe Java**" com o seguinte conteúdo:

```javascript
br.com.centralit.citcorpore.quartz.job.JobConfiguracaoAberturaAutomaticaViaEmail
```

:::hint{type="info"}
**🖊&#x20;**<u>**Nota:**</u> É possível ler o título do e-mail enviado, está guardado no campo **subject** da tabela *read email data request*.
:::

Além disso, caso haja a necessidade de recuperar outras informações constantes nos campos do e-mail, como destinatários marcados como cópia (CC) ou cópia oculta (BCC) utilize o script Rhino abaixo:

```javascript
var importNames = JavaImporter(); importNames.importPackage(Packages.br.com.citframework.util); var print = java.lang.System.out; var readEmailDataDTO = serviceRequest.getReadEmailDataDTO(); if (readEmailDataDTO!=null){ print.println("Dados do E-mail de Origem: "); print.println("From: "); print.println(readEmailDataDTO.getMessageFrom()); print.println("To: "); print.println(readEmailDataDTO.getMessageTo()); print.println("CC (Carbon Copy): "); print.println(readEmailDataDTO.getMessageCC()); }
```

O ticket será criado com o título do E-mail lido.

:::hint{type="success"}
**Regra:&#x20;**&#x20;Para funcionalidade ser ativada, é necessário que o Título possua 3 elementos: "**Ticket    -**&#x20;**&#x20;  $&#x7B;IDSOLICITACAOSERVICO}**". Os termos podem ser inseridos em qualquer ordem, sem diferenciação de maiúsculas e minúsculas, desde que a string completa possua os três elementos: a palavra **Ticket**, o sinal de **-** e um número para ID. Um exemplo que também funcionará: "Abertura **-** Foi criado o **TICKET&#x20;**&#x64;e número **&#x7B;IDSOLICITACAOSERVICO}**"
:::

## Comentários

Após a abertura de um ticket por email, um ticket será criado no portfolio configurado, e as informações do corpo do Email serão inseridas no campo de **Descrição** do ticket.&#x20;

Exemplo: um email com tabela enviado pelo Outlook.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/-BgY76MRBkmRV30hesa3J_image.png)

As informações do email refletidas na descrição do ticket:

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/35RhUn7wp5cfwEH4d00ns_image.png)

Quaisquer comunicações subsequentes pelo mesmo email também serão incluídas no ticket, na seção de **Comentários**:

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/MXi58eFnquAUhz9QpwX9I_image.png)

Na imagem é possível ver um comentário incluido manualmente pelo sistema, e outro comentário inserido através da ação automática, após o email ser respondido no **Outlook**.
