# Onglet des pièces jointes

Ce bloc prend en charge les types de pièces jointes suivants :

* Lien
* Vidéo
* Image
* Fichier
* Audio

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

{% hint style="warning" %}
Dans un seul bloc, vous NE POUVEZ PAS combiner différents types de pièces jointes !

Les pièces jointes téléchargées dans le générateur ne doivent pas dépasser 20 Mo.

L’envoi de jusqu’à 10 pièces jointes du <mark style="color:red;">**même type**</mark> dans un seul bloc est autorisé.
{% endhint %}

Vous pouvez également générer une image à l’aide du **bouton « Générer une image »** et l’envoyer à votre client.

<div data-with-frame="true"><figure><img src="/files/34ec4e524489adeeaedc9cc292cc5b0ee2c87a79" alt="" width="375"><figcaption></figcaption></figure></div>

## Comment envoyer des pièces jointes

Pour envoyer une pièce jointe, créez un bloc vide et ouvrez l’éditeur de bloc (menu de droite).

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

1. La pièce jointe téléchargée ne doit pas dépasser 20 Mo. L’envoi de jusqu’à 10 pièces jointes du <mark style="color:red;">**même type**</mark> dans un seul bloc est autorisé.
2. Il n’est pas recommandé de <mark style="color:red;">**envoyer un bloc avec plusieurs pièces jointes**</mark> dans une diffusion afin d’éviter d’atteindre les limites API de différents messageries.
3. <mark style="color:red;">**NE PAS**</mark> attribuer le <mark style="color:red;">**même nom**</mark> à différentes pièces jointes **au sein d’un même projet**!
4. Si vous téléversez une nouvelle pièce jointe portant le même nom qu’une pièce existante, le système enverra le fichier d’origine. Pour éviter les erreurs et garantir le bon fonctionnement du bloc, attribuez toujours des noms uniques à vos pièces jointes.
   {% endhint %}

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

**Spécificités de Telegram :**

* Boutons <mark style="color:red;">**n’apparaîtra PAS**</mark> lors de l’envoi de plus d’une pièce jointe dans un bloc.
* *Exception :* Si le texte du bloc dépasse 1024 caractères, le message sera divisé en deux — les boutons apparaîtront avec le texte, et les pièces jointes seront envoyées dans un message séparé.
* La mise en forme du texte en Markdown et HTML ne **ne pas** fonctionne pas lors de l’envoi de plus d’une pièce jointe dans un bloc.
  {% endhint %}

Tous les paramètres des pièces jointes se trouvent dans les paramètres du bloc, accessibles en cliquant sur le **« Pièce jointe »** .

<div data-with-frame="true"><figure><img src="/files/1622d486d5533181b24d2ea0fe60007a364751bd" alt="" width="375"><figcaption></figcaption></figure></div>

&#x20;Examinons de plus près les nouveaux boutons apparus pour les types de pièces jointes.

### Lien

Le premier bouton est **Lien**:

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

1. Cliquez sur le bouton pour afficher les paramètres de la pièce jointe.
2. **Option A :** saisissez une URL dans le champ prévu pour partager un lien.
3. **Option B :** téléversez un fichier ; il sera présenté au client comme un lien de téléchargement séparé.

{% hint style="info" %}
Le fichier joint sera envoyé sous forme de lien depuis le serveur mavibot.ai.
{% endhint %}

{% hint style="info" %}
Un fichier téléversé est prioritaire sur un lien. Si les deux sont fournis, le fichier téléversé sera envoyé.
{% endhint %}

Il y a trois cases à cocher sous le champ URL :

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

1. **Notification de clic :** Lorsqu’elle est activée, le bot enregistrera le clic d’un utilisateur en envoyant un message au format `link_was_pressed [link1] [link2]`.

<div data-with-frame="true"><figure><img src="/files/8cb2f3e0b8d131542596d62b74043072f158f643" alt="" width="320"><figcaption></figcaption></figure></div>

À quoi cela sert-il ?

<div data-with-frame="true"><figure><img src="/files/3f58c321638a9ce03ebcf0902ddcbc7bdc6b96b0" alt="" width="375"><figcaption></figcaption></figure></div>

Cet événement vous permet de suivre quels utilisateurs ont cliqué sur un lien. Lorsque la case est activée, le système envoie un callback au dialogue au format :

`link_was_pressed {url}` &#x20;

Dans ce callback, `link_was_pressed` est un préfixe fixe, et `{url}` est une variable représentant l’URL spécifique que vous avez configurée dans le bloc.

<div data-with-frame="true"><figure><img src="/files/06514e0bc7ded4f4b1de6a692d15f31f84b695ba" alt="" width="563"><figcaption></figcaption></figure></div>

Par exemple, vous pouvez ensuite envoyer des rappels aux clients.

{% hint style="info" %}
Pour apprendre à configurer la réponse du bot à un callback de clic sur un lien, consultez la section ci-dessous intitulée [Suivi des clics sur les liens.](#tracking-link-clicks)
{% endhint %}

Vous pouvez définir votre propre domaine pour générer des liens avec des notifications de clic.

Pour cela, rendez-vous dans les paramètres de votre projet :

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

Cliquez sur le bouton « Définir un domaine personnalisé... » et saisissez votre domaine dans la fenêtre modale :

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

{% hint style="info" %}
[Le processus de création et de configuration d’un domaine personnalisé est expliqué ici.](/doc/fr/websites/sites-web/builder.md#domain)
{% endhint %}

Lorsque la notification de clic est activée, le lien envoyé à l’utilisateur sera formaté comme suit :

`https://{your_domain}/{proxy_id}/s`

<div data-with-frame="true"><figure><img src="/files/8ac069069ae85305d42d25b09d952a17c10a4549" alt="" width="375"><figcaption></figcaption></figure></div>

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

2. **case à cocher « Afficher l’aperçu du lien »** case à cocher

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

Cela génère un aperçu enrichi du lien dans le messager, permettant à l’utilisateur de voir un extrait du contenu du fichier (comme un titre, une image ou une description) avant de l’ouvrir.

3. **« Image sous le texte »** case à cocher

<div data-with-frame="true"><figure><img src="/files/421ce06465a21aa1d1e5ef787cf74d284629f59f" alt="" width="375"><figcaption></figcaption></figure></div>

### Pièce jointe vidéo

Bouton de pièce jointe vidéo

<div data-with-frame="true"><figure><img src="/files/83d90af46b3b012e6429932aeae0b2dd470f1f63" alt="" width="375"><figcaption></figcaption></figure></div>

Utilisez cette option lors de l’envoi de vidéos. Par défaut, WhatsApp n’affiche les vidéos que sous forme de liens.

**Pour afficher les vidéos YouTube sous forme de liens dans&#x20;*****tous*****&#x20;les messageries :**

* Raccourcissez l’URL à l’aide d’un raccourcisseur d’URL, ou
* Envoyez-la en tant que pièce jointe avec **la notification de clic** activée.

{% hint style="info" %}
Remarque !&#x20;

Telegram convertit automatiquement les petites pièces jointes vidéo (de moins d’environ 2 Mo) en GIF.
{% endhint %}

Pour les grandes vidéos stockées dans un stockage externe, il est préférable de les joindre sous forme de liens. Le bloc a une limite de téléversement direct de 20 Mo pour les fichiers vidéo.

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

La vidéo est jointe au format MP4.
{% endhint %}

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

### Image

**bouton « Image »** — utilisez-le pour envoyer les images nécessaires dans le bot.

<div data-with-frame="true"><figure><img src="/files/13ebac4da3a1a10a10ae0e89716dba8b139598d1" alt="" width="563"><figcaption></figcaption></figure></div>

Comme toute autre pièce jointe, une image peut être téléversée directement depuis votre ordinateur ou en indiquant son URL.

### Fichier

**Fichier** icône — utilisez-la pour envoyer des documents et tout autre fichier.

<div data-with-frame="true"><figure><img src="/files/48792c93b70cb9e269ef1f7f6f6ba9c8e2179e26" alt="" width="563"><figcaption></figcaption></figure></div>

### **Audio**

**Icône Audio :** utilisez cette icône lors de la pièce jointe ou de l’envoi d’un fichier au format audio (par ex. MP3, WAV).

<div data-with-frame="true"><figure><img src="/files/127b39127a9f508e6dc486e218c1e7d0cd3dc785" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/5ba29d83c6bb76426264f2c7ed7f13d73c670c5e" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Pour Instagram, le format du fichier doit être .m4a.
{% endhint %}

## Envoi de plusieurs fichiers

Pour envoyer plusieurs pièces jointes (vidéos, fichiers, images ou audio) :

1. Accédez à la **« Pièce jointe »** section dans l’éditeur de bloc.
2. Sélectionnez le type de pièce jointe souhaité.
3. Téléversez les fichiers requis un par un.

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

{% hint style="info" %} <mark style="color:red;">**Veuillez tenir compte des contraintes suivantes lors de l’envoi de plusieurs pièces jointes :**</mark>

**Limites générales :**

* **Quantité :** vous pouvez ajouter jusqu’à 10 fichiers du même type simultanément.
* **Taille :** chaque fichier individuel ne doit pas dépasser 20 Mo.

**Comportement spécifique à Telegram :**

* **Mise en forme du texte :** la mise en forme Markdown ou HTML est désactivée dans les messages contenant plusieurs fichiers.
* **Boutons :** les boutons interactifs ne sont pas livrés avec plusieurs pièces jointes.
  {% endhint %}

**Dans Telegram :**&#x20;

* Les boutons sont désactivés lorsqu’un bloc contient plus d’une pièce jointe.

*<mark style="color:blue;">Exception :</mark>* Si le texte du bloc dépasse 1024 caractères, le message est divisé. Les boutons seront envoyés avec le texte, tandis que les pièces jointes seront livrées dans un message séparé.

* <mark style="color:red;">**La mise en forme du texte en Markdown et HTML ne fonctionne pas**</mark> lors de l’envoi de plus d’une pièce jointe dans un bloc.

### Envoi de pièces jointes : exemples

Passons à des exemples pratiques. Nous allons configurer le bot pour envoyer des messages automatiquement à des intervalles de 2 secondes.

Dans chaque bloc d’exemple, nous inclurons un type différent de pièce jointe pour montrer comment elles s’affichent dans Telegram.

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

Le flux d’exemple présente différents types de pièces jointes — fichier, lien, vidéo, image et audio — envoyés successivement avec un délai de 2 secondes.

<div data-with-frame="true"><figure><img src="/files/310e7519be66f8578289d3352034740932b23fbd" alt="" width="375"><figcaption></figcaption></figure></div>


---

# 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/builder/attachments/tab.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.