Email V2 | Digibee Documentation

Digibee Documentation

Atualizado há 1 mês

Isto foi útil?

O Email V2 permite o envio de emails simples, no formato HTML ou até mesmo contendo anexos.

Parâmetros

Dê uma olhada nas opções de configuração do componente. Parâmetros suportados por estão marcados com (DB).

Parâmetro

Descrição

Valor padrão

Tipo de dado

No parâmetro Attachments, para adicionar imagens dentro do corpo do email, deve ser informado o prefixo "cid:" antes do nome da imagem. Ex.: <img src"cid: image.png" />

Fluxo de mensagens

Entrada

Esse componente não espera nenhuma mensagem de entrada específica, somente se for informada uma expressão em Double Braces em algum dos seus campos.

Saída

Ao executar um componente Email V2, a seguinte estrutura de JSON será gerada:

{
    "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"
    }]
}

from: remetente.
to: destinatários.
cc: destinatários em cópia.
bcc: destinatários em cópia oculta.
subject: assunto.
content: corpo da mensagem. Caso o corpo da mensagem exceda 256 caracteres, esse resultado será truncado.
charset: charset.
success: se a chamada foi bem sucedida.
attachments: array contendo os anexos enviados.

A manipulação de arquivos dentro de um pipeline ocorre de forma protegida. Os arquivos ficam disponíveis em diretório temporário que somente o pipeline sendo executado tem acesso.

Email V2 em Ação

Veja abaixo como o componente se comporta em determinada situação e a sua respectiva configuração.

Enviando um arquivo de texto (xpto.txt) como anexo em modo RAW e o corpo do email contendo imagens também

SMTP Host: smtp.gmail.com
SMTP Port: 587
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="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: habilitado
Is Over TLS: habilitado
Attachment As Raw: habilitado
Attachments:

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

O resultado será:

{
    "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" }
    ]
}

Veja como passar valores de forma dinâmica usando o conector:

Neste exemplo de uso dinâmico, passamos variáveis indicando a emissão de notas fiscais <a href='${NF}' com uma segunda variável indicando o vencimento ${M_VENC}.

<!DOCTYPE html>
<html>
<head>
 </head>
<body>
 
Boa tarde, <br/>
Segue a nota fiscal <a href='${NF}'>(Clique aqui)</a> referente a mensalidade de licenciamento da plataforma – com vencimento para <b> ${M_VENC}</b>. <br/>
O pagamento será via <b>transferência bancária</b> - dados no corpo da nota fiscal.   <br/><br/>


Por favor, confirmar o recebimento. <br/>
Qualquer dúvida, estamos à disposição. <br/><br/>
 <br/>
 <br/>
Att.,
Relacionamento com o Cliente
</body>
</html>

Observe que o conector permite o uso de Double Braces:

Dados do 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"
}

Tecnologia

Atualizado há 1 mês

Isto foi útil?

O Email V2 permite o envio de emails simples, no formato HTML ou até mesmo contendo anexos.

Parâmetros

Dê uma olhada nas opções de configuração do componente. Parâmetros suportados por estão marcados com (DB).

Parâmetro

Descrição

Valor padrão

Tipo de dado

No parâmetro Attachments, para adicionar imagens dentro do corpo do email, deve ser informado o prefixo "cid:" antes do nome da imagem. Ex.: <img src"cid: image.png" />

Fluxo de mensagens

Entrada

Esse componente não espera nenhuma mensagem de entrada específica, somente se for informada uma expressão em Double Braces em algum dos seus campos.

Saída

Ao executar um componente Email V2, a seguinte estrutura de JSON será gerada:

{
    "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"
    }]
}

from: remetente.
to: destinatários.
cc: destinatários em cópia.
bcc: destinatários em cópia oculta.
subject: assunto.
content: corpo da mensagem. Caso o corpo da mensagem exceda 256 caracteres, esse resultado será truncado.
charset: charset.
success: se a chamada foi bem sucedida.
attachments: array contendo os anexos enviados.

A manipulação de arquivos dentro de um pipeline ocorre de forma protegida. Os arquivos ficam disponíveis em diretório temporário que somente o pipeline sendo executado tem acesso.

Para entender melhor o fluxo das mensagens na Digibee Integration Platform, leia o artigo sobre .

Email V2 em Ação

Veja abaixo como o componente se comporta em determinada situação e a sua respectiva configuração.

Enviando um arquivo de texto (xpto.txt) como anexo em modo RAW e o corpo do email contendo imagens também

SMTP Host: smtp.gmail.com
SMTP Port: 587
From: (esse email deve ser o mesmo configurado na conta especificada neste componente)
To: ,
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="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: habilitado
Is Over TLS: habilitado
Attachment As Raw: habilitado
Attachments:

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

O resultado será:

{
    "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" }
    ]
}

Veja como passar valores de forma dinâmica usando o conector:

Neste exemplo de uso dinâmico, passamos variáveis indicando a emissão de notas fiscais <a href='${NF}' com uma segunda variável indicando o vencimento ${M_VENC}.

<!DOCTYPE html>
<html>
<head>
 </head>
<body>
 
Boa tarde, <br/>
Segue a nota fiscal <a href='${NF}'>(Clique aqui)</a> referente a mensalidade de licenciamento da plataforma – com vencimento para <b> ${M_VENC}</b>. <br/>
O pagamento será via <b>transferência bancária</b> - dados no corpo da nota fiscal.   <br/><br/>


Por favor, confirmar o recebimento. <br/>
Qualquer dúvida, estamos à disposição. <br/><br/>
 <br/>
 <br/>
Att.,
Relacionamento com o Cliente
</body>
</html>

Observe que o conector permite o uso de Double Braces:

Dados do 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"
}

Tecnologia

Utilizamos o Freemarker para realizar as nossas conversões e transformações no template do corpo do email. Leia a para saber como utilizá-lo.