# Travailler avec les e-mails

##  Pour l’envoi de messages e-mail 

{% hint style="warning" %}
Veuillez noter !

Lors de l’exécution des fonctions de travail avec des messages e-mail, la fonction renvoie :

a) soit <mark style="color:green;">**AUCUN**</mark> — en cas d’exécution réussie de la fonction ;

b) soit <mark style="color:red;">**un statut d’erreur**</mark> texte.
{% endhint %}

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

<details>

<summary>Description</summary>

<mark style="background-color:blue;">**Pour envoyer un message e-mail**</mark>

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

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;to\_email - adresse e-mail du destinataire** adresse e-mail

<mark style="color:red;">**!**</mark>**&#x20;subject -** objet de l’e-mail

<mark style="color:red;">**!**</mark>**&#x20;message -** texte du corps de l’e-mail

<mark style="background-color:blue;">**Pour envoyer des messages e-mail via le bot**</mark>

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

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;email\_bot** - adresse e-mail liée au canal de diffusion des e-mails \ <mark style="color:red;">**!**</mark>**&#x20;client\_email** - adresse e-mail du client à laquelle un message sera envoyé\ <mark style="color:red;">**!**</mark>**&#x20;email\_subject** - objet de l’e-mail (titre)\ <mark style="color:red;">**!**</mark>**&#x20;text** - corps du message envoyé par e-mail \
**attachment\_url** - URL de la pièce jointe&#x20;

<mark style="background-color:blue;">**Pour transférer un brouillon ou un e-mail envoyé**</mark>

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

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;mailing\_id** - ID du modèle d’envoi (soit un brouillon, soit un e-mail prêt à l’envoi)

<mark style="color:red;">**!**</mark>**&#x20;client\_email** - adresse e-mail du destinataire

**email\_bot** - adresse e-mail de l’expéditeur ; par défaut, e-mail connecté au projet

**date** - date d’envoi de l’e-mail au format « dd.mm.yyyy HH:mm ». Si la date est dans le passé ou omise, l’e-mail sera envoyé immédiatement après l’appel de la fonction.

</details>

<details>

<summary>Exemple</summary>

Pour envoyer un message e-mail :

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

Envoi via le bot

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

Exemple d’envoi d’un e-mail précédemment envoyé :

Nous prenons la variable de la liste d’envoi - id.

Dans cet exemple, c’est 483, qui sera utilisé comme mailing\_id.

Nous allons dans le constructeur et appelons la fonction avec les paramètres suivants :

Option 1 – en spécifiant les paramètres explicitement :

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

Option 2 – en spécifiant les paramètres à l’aide de variables :

`mailing_id = '483'`\
`client_email = 'test@mail.ru' # e-mail du destinataire`\
`email_bot = ''`\
`date = '09.08.2022 15:00' # comme la date est déjà passée au moment de l’envoi, l’e-mail sera envoyé immédiatement à l’appel de la fonction`\
`e_letter = send_email_template(mailing_id, client_email, email_bot, date)`

<div data-with-frame="true"><figure><img src="/files/6c70092393c52bbf0c1bb26a9e8a9f80e70ba4be" alt=""><figcaption><p>Exemple de paramétrage pour l’envoi d’un e-mail</p></figcaption></figure></div>

En conséquence, lorsque la fonction a été appelée, le modèle de l’e-mail préalablement préparé a été envoyé à <test@mail.com>.

</details>

<details>

<summary>Exemple de code à copier</summary>

```
send_email('john.smith@gmail.com', 'Ceci est un titre', 'Et ceci est un texte')

/*via le bot*/
mailing = send_email_from_bot('test_channel@test.com', 'test_client@gmail.com', 'Objet de l’e-mail. Juste simple', 'Salut, je t’envoie mon message', 'https://sun9-82.userapi.com/impg/L3ZYWHnlseIQsqZO')
```

</details>

## Pour confirmer les envois à l’adresse e-mail du client

confirm\_email\_subscription()

<details>

<summary>Description</summary>

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

{% hint style="info" %}
Cette fonction est conçue pour recueillir le consentement des clients à l’envoi de campagnes par e-mail.

Lorsqu’un client fournit son adresse e-mail via la messagerie, une demande de consentement est envoyée en premier.
&#x20;Un client e-mail n’est créé qu’après que le client a confirmé son consentement.

En conséquence, les adresses e-mail avec consentement confirmé sont considérées comme plus fiables, ce qui aide à améliorer la délivrabilité globale de vos e-mails et la réputation de l’expéditeur.
{% endhint %}

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

Vous ne pouvez pas envoyer des envois contenant un contenu potentiellement promotionnel sans le consentement du client.

Ne négligez pas cette information afin d’éviter des sanctions en cas d’infraction.
{% endhint %}

Paramètres :

**e-mail** - adresse e-mail du client à vérifier et à ajouter

**sender\_name** - nom de l’entreprise auprès de laquelle vous demandez le consentement pour recevoir les newsletters

**bot\_email** - adresse e-mail du bot à laquelle un nouveau client e-mail sera lié

**callback** - les callbacks sont (ou ne sont pas) requis pour les clients qui confirment leur adresse e-mail et pour un nouveau client e-mail (par défaut : False)

**client\_name** - nom qui sera attribué à un client e-mail

Les callbacks envoyés auront le format suivant :

"client\_accept\_email\_subscription: #{email}" - callback vers un client confirmant son adresse e-mail

"email\_client\_accepted\_by ID:#{@client.id}" - callback vers un nouveau client (l’ID du client confirmant sera stocké dans la variable client\_father\_id)

Envoyez un message pour vérifier l’adresse après que l’utilisateur a fourni son e-mail.

Après que l’utilisateur a confirmé son consentement à recevoir des newsletters de l’entreprise, un nouveau client e-mail sera ajouté à votre liste.

De cette façon, vous n’aurez pas de « leads morts » dans vos campagnes, et votre base de données e-mail ne sera composée que d’adresses de clients réellement intéressés par vos produits.

</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/fr/chatbot/functions/calculatrice/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.