# Trabalhando com e-mail

##  Para enviar mensagens de e-mail 

{% hint style="warning" %}
Por favor, observe!

Ao executar funções para trabalhar com mensagens de e-mail, a função retorna:

a) ou <mark style="color:verde;">**NENHUM**</mark> — após a execução bem-sucedida da função;

b) ou <mark style="color:vermelho;">**um status de erro**</mark> texto.
{% endhint %}

send\_email() | send\_email\_from\_bot() | send\_email\_template()

<details>

<summary>Descrição</summary>

<mark style="color:padrão;background-color:blue;">**Para enviar uma mensagem de e-mail**</mark>

**send\_email(to\_email, subject, message)**&#x20;

Parâmetros:

<mark style="color:vermelho;">**!**</mark>**&#x20;to\_email - endereço de e-mail do destinatário** endereço de e-mail

<mark style="color:vermelho;">**!**</mark>**&#x20;subject -** assunto do e-mail

<mark style="color:vermelho;">**!**</mark>**&#x20;message -** texto do corpo do e-mail

<mark style="color:padrão;background-color:blue;">**Para enviar mensagens de e-mail via o bot**</mark>

**send\_email\_from\_bot(email\_bot, client\_email, email\_subject, text, attachment\_url)**&#x20;

Parâmetros:

<mark style="color:vermelho;">**!**</mark>**&#x20;email\_bot** - endereço de e-mail vinculado ao canal de distribuição de e-mails \ <mark style="color:vermelho;">**!**</mark>**&#x20;client\_email** - endereço de e-mail do cliente para o qual a mensagem será enviada\ <mark style="color:vermelho;">**!**</mark>**&#x20;email\_subject** - assunto (título) do e-mail\ <mark style="color:vermelho;">**!**</mark>**&#x20;text** - corpo da mensagem enviado por e-mail \
**attachment\_url** - URL do anexo&#x20;

<mark style="color:padrão;background-color:blue;">**Para encaminhar um rascunho ou e-mail enviado**</mark>

**send\_email\_template(mailing\_id, client\_email, email\_bot, date)**

Parâmetros:

<mark style="color:vermelho;">**!**</mark>**&#x20;mailing\_id** - ID do modelo de envio (seja um rascunho ou um e-mail pronto)

<mark style="color:vermelho;">**!**</mark>**&#x20;client\_email** - endereço de e-mail do destinatário

**email\_bot** - endereço de e-mail do remetente; por padrão, e-mail conectado ao projeto

**date** - data de envio do e-mail no formato ‘dd.mm.aaaa HH:mm’. Se a data estiver no passado ou for omitida, o e-mail será enviado imediatamente após a chamada da função.

</details>

<details>

<summary>Exemplo</summary>

Para enviar uma mensagem de e-mail:

<div data-with-frame="true"><figure><img src="/files/bcfe3f671b53bb7e38e2c70f07fdf34a8b6ac35f" alt=""><figcaption></figcaption></figure></div>

Enviando via o bot

<div data-with-frame="true"><figure><img src="/files/531c2fa8ae6d2ef6ac4db42a24791ccf3c6fd5bb" alt=""><figcaption></figcaption></figure></div>

Exemplo de envio de um e-mail enviado anteriormente:

Pegamos a variável da lista de envio - id.

Neste exemplo, é 483, que será usado como mailing\_id.

Vamos ao construtor e chamamos a função com os seguintes parâmetros:

Opção 1 – especificando os parâmetros explicitamente:

`e_letter = send_email_template('483', "test@mail.ru", '', '09.08.2022 15:00')`

Opção 2 – especificando os parâmetros usando variáveis:

`mailing_id = '483'`\
`client_email = 'test@mail.ru' # e-mail do destinatário`\
`email_bot = ''`\
`date = '09.08.2022 15:00' # como a data já passou no momento do envio, o e-mail será enviado imediatamente após a chamada da função`\
`e_letter = send_email_template(mailing_id, client_email, email_bot, date)`

<div data-with-frame="true"><figure><img src="/files/d7651b65d15e8344a0739633b9e51e15038ea1c4" alt=""><figcaption><p>Exemplo de configuração para enviar um e-mail</p></figcaption></figure></div>

Como resultado, quando a função foi chamada, o modelo do e-mail pré-preparado foi enviado para <test@mail.com>.

</details>

<details>

<summary>Exemplo de código para copiar</summary>

```
send_email('john.smith@gmail.com', 'Este é um título', 'E este é um texto')

/*via o bot*/
mailing = send_email_from_bot('test_channel@test.com', 'test_client@gmail.com', 'Assunto do e-mail. Simples assim', 'Oi, estou te enviando minha mensagem', 'https://sun9-82.userapi.com/impg/L3ZYWHnlseIQsqZO')
```

</details>

## Para confirmar envios para o endereço de e-mail do cliente

confirm\_email\_subscription()

<details>

<summary>Descrição</summary>

**confirm\_email\_subscription(email, sender\_name, bot\_email, callback,client\_name)**

{% hint style="info" %}
Esta função foi projetada para coletar o consentimento dos clientes para o envio de campanhas por e-mail.

Quando um cliente fornece seu endereço de e-mail via mensageiro, uma solicitação de consentimento é enviada primeiro.
&#x20;Um cliente de e-mail é criado somente após o cliente confirmar seu consentimento.

Como resultado, endereços de e-mail com consentimento confirmado são considerados mais confiáveis, o que ajuda a melhorar a entregabilidade geral dos seus e-mails e a reputação do remetente.
{% endhint %}

{% hint style="warning" %}
Importante!&#x20;

Você não pode enviar campanhas contendo conteúdo potencialmente promocional sem o consentimento do cliente.

Não desconsidere esta informação para evitar penalidades por violações.
{% endhint %}

Parâmetros:

**email** - endereço de e-mail do cliente para verificação e adição

**sender\_name** - nome da empresa da qual você solicita consentimento para receber newsletters

**bot\_email** - endereço de e-mail do bot ao qual um novo cliente de e-mail будет vinculado

**callback** - callbacks são (ou não são) necessários para clientes que confirmam seu endereço de e-mail e para um novo cliente de e-mail (padrão: False)

**client\_name** - nome que será atribuído a um cliente de e-mail

Os callbacks enviados terão o seguinte formato:

"client\_accept\_email\_subscription: #{email}" - callback para um cliente confirmando seu endereço de e-mail

"email\_client\_accepted\_by ID:#{@client.id}" - callback para um novo cliente (o ID do cliente que confirma será armazenado na variável client\_father\_id)

Envie uma mensagem para verificar o endereço depois que o usuário fornecer seu e-mail.

Depois que o usuário confirmar seu consentimento para receber newsletters da empresa, um novo cliente de e-mail será adicionado à sua lista.

Dessa forma, você não terá "leads mortos" em suas campanhas, e seu banco de dados de e-mails consistirá apenas de endereços de clientes genuinamente interessados em seus produtos.

</details>


---

# Agent Instructions: 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:

```
GET https://docs.mavibot.ai/doc/pt/chatbot/functions/calculadora/email.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.