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

  • Lien
  • Vidéo
  • Image
  • Fichier
  • Audio

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 builder ne doivent pas dépasser 20 Mo.

L'envoi de jusqu'à 10 pièces jointes du même type dans un seul bloc est autorisé.

Vous pouvez également générer une image à l'aide du bouton "Générer une image" et l'envoyer à votre client.

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).

Important !

  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 même type dans un seul bloc est autorisé.
  2. Il n'est pas recommandé d'envoyer un bloc avec plusieurs pièces jointes dans une diffusion pour éviter d'atteindre les limites de l'API des différents messagers.
  3. N'attribuez PAS le même nom à différentes pièces jointes dans un même projet !
  4. Si vous téléchargez une nouvelle pièce jointe avec le même nom qu'une pièce existante, le système délivrera le fichier d'origine. Pour éviter les erreurs et garantir le bon fonctionnement du bloc, attribuez toujours des noms uniques à vos pièces jointes.

Veuillez noter !

Spécificités Telegram :

  • Les boutons n'apparaîtront PAS lors de l'envoi de plusieurs pièces jointes 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é.
  • Le formatage de texte Markdown et HTML ne fonctionne pas lors de l'envoi de plusieurs pièces jointes dans un bloc.

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

Examinons de plus près les boutons nouvellement apparus pour les types de pièces jointes.

Lien

Le premier bouton est Lien :

  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 à cet effet pour partager un lien.
  3. Option B : téléchargez un fichier ; il sera présenté au client comme un lien de téléchargement séparé.

Le fichier joint sera envoyé sous forme de lien depuis le serveur mavibot.ai.

Un fichier téléchargé a priorité sur un lien. Si les deux sont fournis, le fichier téléchargé sera envoyé.

Il y a trois cases à cocher en dessous du champ URL :

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

À quoi cela sert-il ?

Cet événement vous permet de suivre les utilisateurs qui ont cliqué sur un lien. Lorsque la case est cochée, le système envoie un callback à la boîte de dialogue au format :

link_was_pressed {url}

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.

Par exemple, vous pouvez envoyer des rappels aux clients par la suite.

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.

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

Pour ce faire, allez dans les paramètres de votre projet :

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

Le processus de création et de configuration d'un domaine personnalisé est expliqué ici.

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

https://{votre_domaine}/{proxy_id}/s

  1. Case à cocher "Afficher l'aperçu du lien"

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.

  1. Case à cocher "Image sous le texte"

Pièce jointe vidéo

Bouton de pièce jointe vidéo

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 tous les messagers :

  • Raccourcissez l'URL à l'aide d'un réducteur d'URL, ou
  • Envoyez-la en tant que pièce jointe avec la notification de clic activée.

Remarque !

Telegram convertit automatiquement les petites pièces jointes vidéo (moins de ~2 Mo) en GIF.

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échargement direct de 20 Mo pour les fichiers vidéo.

Veuillez noter !

La vidéo est jointe au format MP4.

Image

Bouton "Image" — utilisez-le pour envoyer les images nécessaires dans le bot.

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

Fichier

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

Audio

Icône Audio : utilisez cette icône lors de la jointure ou de l'envoi d'un fichier au format audio (par exemple, MP3, WAV).

Pour Instagram, le format du fichier doit être .m4a.

Envoi de plusieurs fichiers

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

  1. Accédez à la section "Pièce jointe" dans l'éditeur de bloc.
  2. Sélectionnez le type de pièce jointe souhaité.
  3. Téléchargez les fichiers requis un par un.

Veuillez prendre en compte les contraintes suivantes lors de l'envoi de plusieurs pièces jointes :

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 :

  • Formatage du texte : le formatage markdown ou HTML est désactivé dans les messages contenant plusieurs fichiers.
  • Boutons : les boutons interactifs ne sont pas délivrés avec plusieurs pièces jointes.

Dans Telegram :

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

Exception : 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 sont délivrées dans un message séparé.

  • Le formatage de texte Markdown et HTML ne fonctionne pas lors de l'envoi de plusieurs pièces jointes dans un bloc.

Envoi de pièces jointes : exemples

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

Dans chaque bloc d'exemple, nous inclurons un type de pièce jointe différent pour démontrer comment ils sont affichés dans Telegram.

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