> For the complete documentation index, see [llms.txt](https://docs.digibee.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/web-protocols/email-v2.md).

# Email V2

O conector **Email V2** permite o envio de e-mails simples em formato HTML, com ou sem anexos.

## **Parâmetros**

Configure o conector utilizando os parâmetros abaixo. Os campos que suportam [expressões Double Braces](/documentation/connectors-and-triggers/pt-br/double-braces/overview.md) estão marcados na coluna **Suporta DB**.

{% tabs %}
{% tab title="General" %}

<table><thead><tr><th width="112">Parâmetro</th><th width="231">Descrição</th><th width="83">Tipo de dado</th><th width="81">Suporta DB</th><th width="100">Valor padrão</th><th width="128">Visível quando</th></tr></thead><tbody><tr><td><strong>Alias</strong></td><td>Nome (alias) para a saída deste conector, permitindo referenciá-la posteriormente no fluxo usando <a href="/pages/CNhjMiHwGiGjmVcUAGvL#referenciando-etapas-anteriores-usando-o-previous-steps-access">expressões Double Braces</a>.</td><td>String</td><td>✅</td><td><code>email-v2-1</code></td><td>—</td></tr><tr><td><strong>Account Type</strong></td><td>Tipo de conta usada para autenticação. Suportados: <strong>Azure Key</strong> e <strong>Basic</strong>.</td><td>String</td><td>❌</td><td><code>Basic</code></td><td>—</td></tr><tr><td><strong>Use Dynamic Account</strong></td><td>Se habilitado, o conector usa a conta de forma dinâmica via o conector <a href="/pages/iulYYuz29bvfGjceZb4e"><strong>Store Account</strong>;</a> caso contrário, usa a conta estática configurada em <a href="/spaces/cO0A6g1dOsu8BiHYqO67/pages/fS1QLzAg8rGSSJFwtrvy"><strong>Contas</strong></a> na Plataforma.</td><td>Boolean</td><td>❌</td><td><code>false</code></td><td>—</td></tr><tr><td><strong>Scoped</strong></td><td>Se habilitado, isola a conta armazenada de outros subprocessos. Não é suportado para contas usadas em headers ou body. Para saber mais, consulte a <a href="/spaces/cO0A6g1dOsu8BiHYqO67/pages/FrKJOmsImCRBImMPMsU2">documentação de Dynamic Accounts</a>.</td><td>Boolean</td><td>❌</td><td><code>false</code></td><td><strong>Use Dynamic Account</strong> está habilitado</td></tr><tr><td><strong>Account Name</strong></td><td>Nome da conta definida no conector <a href="/pages/iulYYuz29bvfGjceZb4e"><strong>Store Account</strong></a>.</td><td>String</td><td>✅</td><td>N/A</td><td><strong>Use Dynamic Account</strong> está habilitado</td></tr><tr><td><strong>Account</strong></td><td>Conta usada para autenticar com o servidor de e-mail. Obrigatória caso o serviço exija autenticação. Deve ser do tipo de conta <strong>Azure Key</strong> ou <strong>Basic</strong>, configurada em <a href="/spaces/cO0A6g1dOsu8BiHYqO67/pages/fS1QLzAg8rGSSJFwtrvy"><strong>Contas</strong></a> na Plataforma.</td><td>String</td><td>❌</td><td>N/A</td><td><strong>Use Dynamic Account</strong> está desabilitado</td></tr><tr><td><strong>SMTP Host</strong></td><td>Host do servidor SMTP. Exemplo: <code>smtp.gmail.com</code></td><td>String</td><td>✅</td><td><code>smtp.gmail.com</code></td><td>—</td></tr><tr><td><strong>SMTP Port</strong></td><td>Porta do servidor SMTP. Comumente 587, mas pode variar.</td><td>Integer</td><td>✅</td><td><code>587</code></td><td>—</td></tr><tr><td><strong>From</strong></td><td>Endereço de e-mail do remetente.</td><td>String</td><td>✅</td><td>N/A</td><td>—</td></tr><tr><td><strong>To</strong></td><td>Endereço(s) de e-mail do(s) destinatário(s), separados por vírgulas.</td><td>String</td><td>✅</td><td>N/A</td><td>—</td></tr><tr><td><strong>CC</strong></td><td>Destinatário(s) em cópia (CC), separados por vírgulas.</td><td>String</td><td>✅</td><td>N/A</td><td>—</td></tr><tr><td><strong>BCC</strong></td><td>Destinatário(s) em cópia oculta (BCC), separados por vírgulas.</td><td>String</td><td>✅</td><td>N/A</td><td>—</td></tr><tr><td><strong>Subject</strong></td><td>Assunto do email.</td><td>String</td><td>✅</td><td>N/A</td><td>—</td></tr><tr><td><strong>Charset</strong></td><td>Conjunto de caracteres do corpo do email.</td><td>String</td><td></td><td><code>UTF-8</code></td><td>—</td></tr><tr><td><strong>Content</strong></td><td>Corpo do email. Suporta templates Freemarker para HTML dinâmico.</td><td>String</td><td>✅</td><td>N/A</td><td>—</td></tr><tr><td><strong>Custom Attachments Specification</strong></td><td>Habilita a entrada de anexos em formato bruto e oculta o campo de anexos baseado em formulário.</td><td>Boolean</td><td>❌</td><td><code>false</code></td><td>—</td></tr><tr><td><strong>Attachments</strong></td><td>Anexos do email. Especificados via formulário ou array bruto.</td><td>Array of objects</td><td>❌</td><td>N/A</td><td><strong>Custom Attachments Specification</strong> está habilitado</td></tr><tr><td><strong>Authenticated</strong></td><td>Habilite caso seja necessária autenticação SMTP.</td><td>Boolean</td><td>❌</td><td><code>true</code></td><td>—</td></tr><tr><td><strong>Is Over TLS</strong></td><td>Habilite para enviar a mensagem via TLS.</td><td>Boolean</td><td>❌</td><td><code>true</code></td><td>—</td></tr><tr><td><strong>Is Over SSL</strong></td><td>Habilite para enviar a mensagem via SSL.</td><td>Boolean</td><td>❌</td><td><code>false</code></td><td><strong>Is Over TLS</strong> está desabilitado</td></tr><tr><td><strong>Socket Port</strong></td><td>Obrigatório caso o SSL esteja habilitado. Especifica a porta utilizada.</td><td>Integer</td><td>✅</td><td>N/A</td><td><strong>Is Over SSL</strong> está habilitado</td></tr><tr><td><strong>Force TLSv1.2</strong></td><td>Força o uso de TLS 1.2 para conexões seguras com o servidor de e-mail.</td><td>Boolean</td><td>❌</td><td><code>false</code></td><td>—</td></tr><tr><td><strong>Fail On Error</strong></td><td>Se habilitado, interrompe a execução do pipeline quando ocorre um erro. Se desabilitado, a execução prossegue, mas a propriedade <code>"success"</code> será definida como <code>false</code>.</td><td>Boolean</td><td>❌</td><td><code>false</code></td><td>—</td></tr></tbody></table>

{% hint style="info" %}
Para incorporar imagens no corpo do e-mail, use o prefixo `cid:` no parâmetro **Attachments**, seguido do nome da imagem. Exemplo: `<img src="cid:image.png" />`
{% endhint %}
{% endtab %}

{% tab title="Documentation" %}

| Parâmetro         | Descrição                                                                                          | Tipo de dado | Suporta DB | Valor padrão |
| ----------------- | -------------------------------------------------------------------------------------------------- | ------------ | ---------- | ------------ |
| **Documentation** | Campo opcional para descrever a configuração do conector e quaisquer regras de negócio relevantes. | String       | ❌          | N/A          |
| {% endtab %}      |                                                                                                    |              |            |              |
| {% endtabs %}     |                                                                                                    |              |            |              |

## **Fluxo de mensagens**

### **Entrada**

Não é necessária nenhuma mensagem de entrada específica, a menos que alguma expressão Double Braces seja usada em um dos campos.

### **Saída**

O conector retorna um objeto JSON como este:

```json
{
  "from": "a@a.com",
  "to": "a@a.com,a@a.com.br",
  "cc": "a@a.com,a@a.com.br",
  "bcc": "a@a.com,a@a.com.br",
  "subject": "Subject",
  "content": "<html>Test Email!</html>",
  "charset": "UTF-8",
  "success": true,
  "attachments": [
    {
      "type": "ATTACHMENT",
      "attachment": "attachment.extension"
    }
  ]
}
```

**Explicação dos campos:**

* `from`: Email do remetente
* `to`: Destinatários
* `cc`: Destinatários em cópia
* `bcc`: Destinatários em cópia oculta
* `subject`: Assunto do email
* `content`: Corpo do email (será truncado se exceder 256 caracteres)
* `charset`: Codificação de caracteres utilizada
* `success`: Indica se o envio da mensagem foi bem-sucedido
* `attachments`: Lista de anexos

{% hint style="info" %}
Os arquivos são manipulados de forma segura em um diretório temporário exclusivo do pipeline.
{% endhint %}

Saiba mais sobre o [processamento de mensagens](/documentation/developer-guide/pt-br/development-cycle/build-overview/pipelines/messages-processing.md) na Digibee Integration Platform.

## **Email V2 em ação**

### **Autenticação**

O conector **Email V2** suporta os seguintes métodos de autenticação:

**Basic**

* Use uma conta do tipo Basic, onde o **username** é o e-mail do remetente e a **password** é a senha correspondente.

**OAuth 2**

{% hint style="warning" %}
Atualmente compatível apenas com contas de e-mail Microsoft (Outlook).
{% endhint %}

Para configurar:

* Preencha o campo **From** com o endereço de e-mail do remetente.
* Selecione uma **Azure Key** com as credenciais necessárias.

Internamente, o conector utiliza `client-id`, `client-secret` e `tenant-id` para gerar um token, que é usado junto ao email do remetente para autenticar com o servidor SMTP.

### **Exemplo: Email com anexos e imagem embutida (modo RAW)**

**Configuração:**

* **SMTP Host**: [smtp.gmail.com](http://smtp.gmail.com)
* **SMTP Port**: 587
* **From**: <email@gmail.com> (mesmo email configurado no parâmetro **Account**)
* **To**: <some_other_email@gmail.com>, <second_email@gmail.com>
* **Subject**: Hello
* **Content**:

```html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  <title>Demystifying Email Design</title>
  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
</head>
<body>
<img src="cid:myImage.png" />
</body>
</html>
```

* **Authenticated**: true
* **Is Over TLS**: true
* **Attachment As Raw**: true
* **Attachments**:

```json
[
  { "type": "INLINE", "attachment": "myImage.png" },
  { "type": "ATTACHMENT", "attachment": "xpto.txt" }
]
```

**Saída:**

```json
{
    "from": "email@gmail.com",
    "to": "some_other_email@gmail.com,second_email@gmail.com",
    "cc":"",
    "bcc": "",
    "subject": "Hello",
    "content": "<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv ...TRUNCATED",
    "charset": "UTF-8",
    "success": true,
    "attachments": [
        {"type": "INLINE", "attachment": "myImage.png" },
        {"type": "ATTACHMENT", "attachment": "xpto.txt" }
    ]
}
```

### **Exemplo dinâmico com expressões Double Braces**

Você pode usar [**expressões Double Braces**](/documentation/connectors-and-triggers/pt-br/double-braces/overview.md) para inserir variáveis dinamicamente na configuração do conector.

Neste exemplo, o componente [**JSON Generator (Mock)**](/documentation/connectors-and-triggers/pt-br/connectors/tools/json-generator.md) foi configurado com os seguintes dados:

#### **JSON de entrada:**

```json
{
    "remetente": "digibee@gmail.com",
    "destinatario" : "digi@gmail.com",
    "destinatario_cc" : "digi1@gmail.com",
    "destinatario_bcc" : "digi2@gmail.com",
    "port" : "587",
    "host": "smtp.gmail.com",
    "NF": "98787979789",
    "M_VENC" : "13/01/2023"
}
```

Em seguida, o conector **Email V2** foi configurado da seguinte forma:

* **SMTP Host:** `{{ message.host }}`
* **SMTP Port:** `{{ message.port }}`
* **From:** `{{ message.remetente }}`
* **To:** `{{ message.destinatario }}`
* **CC:** `{{ message.destinatario_cc }}`
* **BCC:** `{{ message.destinatario_bcc }}`
* **Subject:** `{{ CONCAT("Nota fiscal ", FORMATDATE(NOW(), "timestamp", "MMMM yyyy", null, "UTC", "pt-BR", "GMT-3")) }}`
* **Charset:** `UTF-8: Eight-bit Unicode (or UCS) Transformation Format`
* **Content:**

```html
<!DOCTYPE html>
<html>
<head>
</head>
<body>

Boa tarde, <br/>
Segue a nota fiscal <a href='${NF}'>(Clique aqui)</a> referente à mensalidade da plataforma – com vencimento em <b>${M_VENC}</b>. <br/>
O pagamento será via <b>transferência bancária</b>, conforme dados informados na nota fiscal. <br/><br/>

Por favor, confirme o recebimento. <br/>
Em caso de dúvidas, estamos à disposição. <br/><br/>

<br/>
<br/>
Att.,<br/>
Relacionamento com o cliente

</body>
</html>
```

### **Tecnologia**

O conector utiliza [Freemarker](https://freemarker.apache.org/docs/dgui_template_exp.html) para geração de conteúdo dinâmico.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/web-protocols/email-v2.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
