> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Créer, tester et envoyer en masse des modèles WhatsApp > Construisez des modèles WhatsApp approuvés par Meta avec en-têtes, corps et boutons, testez sur un vrai appareil, puis envoyez en masse avec import CSV ou Excel, planification et progression en direct. Flowella WhatsApp templates list Les modèles WhatsApp sont des formats de message pré-approuvés qui vous permettent d'envoyer des messages structurés à vos contacts. Ils sont essentiels pour atteindre les gens en dehors de la fenêtre de service client de 24 heures — pour les notifications, mises à jour, rappels et plus encore. Les modèles peuvent inclure des médias riches comme des images et des vidéos, des variables texte dynamiques et des boutons interactifs. ## Ce que sont les modèles et pourquoi ils nécessitent l'approbation de Meta Parce que les modèles WhatsApp sont envoyés en dehors de la fenêtre de conversation standard, Meta examine chaque modèle avant qu'il ne puisse être utilisé. Le processus d'approbation garantit que les messages respectent les standards de qualité et les politiques commerciales de WhatsApp. Les raisons de rejet courantes incluent un langage trop promotionnel, un contenu trompeur ou une mauvaise grammaire, donc il vaut la peine de garder votre texte clair et centré sur une valeur réelle pour le destinataire. Une fois qu'un modèle est approuvé par Meta, vous pouvez l'utiliser dans les workflows Flowella, les flows automatisés, les campagnes et les envois manuels depuis la boîte de réception. Toute modification de la structure d'un modèle nécessite une resoumission — mais les variables dynamiques vous permettent de personnaliser chaque message sans approbations supplémentaires. L'approbation est souvent quasi-instantanée. Meta exécute une revue automatisée de premier niveau qui traite la plupart des modèles en quelques minutes, mais tout ce qui est acheminé pour une revue humaine peut prendre **jusqu'à 48 heures**. Soumettez à l'avance pour qu'une revue plus lente ne bloque jamais un envoi en production. Vous cherchez une référence rapide sur les catégories, les formats d'en-tête, les types de boutons, la syntaxe des variables `{{n}}` ou le cycle de vie de soumission ? Voir [Référence des modèles](/fr/app/template-reference). ## Créer un modèle ### Choisir un point de départ Cliquer sur **Nouveau modèle** (ou naviguer vers `/{org}/templates/new`) ouvre un sélecteur avec trois façons de commencer : * **Créer le vôtre** — rédigez le message vous-même. Choisissez l'une des deux options : * **Message standard** — ouvrez l'éditeur vierge pour un modèle avec un en-tête, un corps, un pied et des boutons optionnels. * **Carrousel** (marqué **NOUVEAU**) — ouvrez l'éditeur de carrousel pour créer un ensemble défilant de cartes image ou vidéo. Voir [Construire un modèle carrousel](#construire-un-modèle-carrousel). * **Bibliothèque Meta** — parcourez le propre catalogue de modèles utilitaires pré-construits de Meta. Ceux-ci sont pré-vérifiés par Meta et généralement approuvés rapidement. * **Modèles Flowella** — un catalogue organisé de modèles de démarrage qui présentent les capacités de Flowella (boutons Flow, coupons, réengagement, etc.). **Carrousel** reste désactivé tant que vous n'avez pas connecté de numéro WhatsApp. Chaque carte a besoin de sa propre image ou vidéo, et Flowella téléverse ce média vers Meta via votre numéro connecté. Survolez l'option désactivée pour afficher une info-bulle qui l'explique. Vous pouvez faire un deep-link directement vers une option spécifique avec le paramètre de requête `entry` : `?entry=meta`, `?entry=flowella`, `?entry=scratch` (message standard) ou `?entry=carousel`. L'étape **Créer votre premier modèle** du guide de prise en main utilise `?entry=meta` pour arriver directement sur la Bibliothèque Meta. Les deux galeries affichent des **cartes d'aperçu WhatsApp partagées** pour que ce que vous voyez en parcourant corresponde à la façon dont les modèles s'affichent dans le catalogue des modèles — même aperçu d'en-tête, corps et boutons. #### Galerie Bibliothèque Meta La galerie Bibliothèque Meta vous permet de rechercher dans le catalogue de modèles utilitaires de Meta et d'ajouter des modèles sans les réécrire. * **Rechercher** — tapez pour filtrer par nom ; les résultats sont debounced et mis en cache pendant environ une heure par WABA. * **Filtre de langue** — par défaut la galerie est filtrée sur la langue WhatsApp dérivée de la **langue de contenu** de votre organisation (définie sous **Réglages → Organisation**). Basculez **Toutes les langues** pour parcourir chaque locale Meta. * **Ouvrir un comme brouillon** — cliquez sur **Ouvrir comme brouillon** sur une carte pour instancier ce modèle comme brouillon local et sauter directement dans l'éditeur. Rien n'est soumis à Meta tant que vous ne cliquez pas sur **Publier**. * **Ajout multi-sélection** — cochez la case sur plusieurs cartes, puis cliquez sur **Créer des brouillons (**{count}**)** pour instancier tous les modèles sélectionnés en une seule fois. En cas de succès, Flowella vous ramène à la liste des modèles. Les sélections de la Bibliothèque s'ouvrent toujours en **brouillons locaux** dans votre WABA. Vous pouvez renommer, modifier les variables, ajouter des boutons ou changer de catégorie avant de publier — l'entrée de la Bibliothèque Meta n'est qu'un point de départ. #### Galerie Modèles Flowella La galerie Modèles Flowella liste les modèles de démarrage organisés maintenus par Flowella (flows de statut de commande, promos coupon, rappels de rendez-vous, etc.). Choisissez un modèle de démarrage pour préremplir l'éditeur avec un brouillon prêt à personnaliser, puis publiez sur Meta lorsque vous êtes satisfait. En coulisses, la galerie vous dépose dans l'éditeur via `?starter=`. ### Remplir l'éditeur Saisissez un nom descriptif qui reflète la finalité du modèle. Utilisez uniquement des lettres minuscules, chiffres et underscores — par exemple, `order_confirmation` ou `appointment_reminder`. Les espaces et caractères spéciaux ne sont pas autorisés par Meta. Ajoutez éventuellement une image ou une vidéo comme en-tête de modèle pour rendre votre message plus engageant. Le média d'en-tête est optionnel mais recommandé. Les images doivent faire moins de 5 Mo et les vidéos moins de 10 Mo. Les vidéos devraient durer moins de 60 secondes et s'ouvrir sur une image engageante. Saisissez le texte principal du corps de votre modèle. Gardez-le clair, concis et pertinent pour votre audience. Utilisez des doubles accolades pour ajouter des variables dynamiques — par exemple, `Hi {{1}}, your order {{2}} is ready for pickup!`. Elles sont remplacées par les vraies données du contact lorsque Flowella envoie le message. Évitez le langage trop promotionnel. La revue de Meta recherche les messages qui apportent une valeur claire au destinataire. Cliquez sur **Ajouter un bouton à votre modèle** pour inclure un élément interactif. Les boutons donnent aux contacts une étape suivante claire et augmentent l'engagement. Vous pouvez ajouter jusqu'à trois boutons par modèle. Choisissez le type de bouton qui correspond à votre cas d'usage : * **Bouton call-to-action** — dirige les utilisateurs vers un site web ou un numéro de téléphone. * **Bouton de réponse rapide** — permet aux utilisateurs de répondre avec un texte prédéfini. * **Bouton URL** — envoie les utilisateurs vers une page web spécifique. Vous pouvez mélanger les types de boutons sur le même modèle. Par exemple, combinez un bouton URL étiqueté « Voir la commande » avec un bouton de réponse rapide étiqueté « Contacter le support ». Saisissez l'action ou la destination du bouton — par exemple, un numéro de téléphone pour un bouton d'appel ou une URL pour un bouton de lien. Saisissez le libellé qui apparaîtra sur le bouton. Faites-le orienté action et clair — par exemple, « En savoir plus », « Nous contacter » ou « Commencer ». Le texte du bouton a une limite de 25 caractères. Utilisez des verbes d'action courts et rendez évident ce qui se passe lorsque le bouton est tapé. Cliquez sur **Créer le modèle** pour enregistrer et soumettre votre modèle. Soumettre le modèle l'envoie à Meta pour revue. C'est souvent quasi-instantané, car la plupart des modèles passent la revue automatisée de Meta en quelques minutes, même si certains sont acheminés pour une revue humaine et peuvent prendre jusqu'à 48 heures. Pendant la revue, Meta vérifie la conformité à la politique. Assurez-vous que votre modèle apporte une valeur claire aux destinataires et évite le langage promotionnel qui pourrait mener à un rejet. Les modèles soumis atterrissent dans l'état **En attente**. La plupart passent la revue automatisée de Meta en quelques minutes ; certains sont acheminés pour une revue humaine. Meta vous indique que l'approbation **peut prendre jusqu'à 12 heures** et Flowella vous **enverra un e-mail** dès que le statut change. Vous n'avez pas besoin de continuer à rafraîchir la page. Une fois que Meta a approuvé le modèle, vous pouvez l'utiliser dans les workflows Flowella, les flows automatisés, la boîte de réception et les envois en masse. ### Construire un modèle carrousel Un modèle carrousel envoie une bulle de message suivie d'une rangée de cartes que le destinataire fait défiler horizontalement. Chaque carte a sa propre image ou vidéo, un texte optionnel et des boutons. Utilisez un carrousel pour présenter plusieurs produits, offres ou options dans un seul message marketing. **Prérequis :** un numéro WhatsApp connecté, et un fichier image ou vidéo pour chaque carte. Cliquez sur **Nouveau modèle**, puis sur **Carrousel** dans la carte **Créer le vôtre**. L'éditeur s'ouvre avec un badge **Carrousel · {count} cartes** à côté du nom du modèle. Saisissez le texte du corps qui apparaît dans la bulle de message au-dessus des cartes. La catégorie est verrouillée sur **Marketing**. Les carrousels n'ont ni en-tête, ni pied, ni boutons au niveau du message. Les boutons se trouvent sur chaque carte. Sous **Structure des cartes**, choisissez le **Type de média** pour toutes les cartes : **Image** ou **Vidéo**. Toutes les cartes utilisent le même type de média. Activez **Corps de carte** si vous voulez du texte sur chaque carte. Une fois activé, chaque carte doit avoir un texte de corps, jusqu'à **160 caractères** par carte. Sous **Boutons des cartes**, ajoutez jusqu'à **2 boutons**. Chaque bouton est une **Réponse rapide**, un **Lien** ou un **Numéro de téléphone**. Chaque carte reçoit les mêmes types de boutons dans le même ordre. Vous définissez le libellé, le lien ou le numéro de téléphone de chaque bouton sur la carte elle-même, de sorte que chaque carte peut pointer vers une destination différente. Un nouveau carrousel commence avec 2 cartes. Cliquez sur **Ajouter une carte** pour en ajouter d'autres, jusqu'à **10 cartes**. Sur chaque carte, téléversez l'image ou la vidéo, rédigez le texte de la carte et définissez les libellés et valeurs des boutons. L'aperçu affiche les cartes sous forme de bande horizontale, comme WhatsApp les affiche. Cliquez sur **Publier** pour soumettre le carrousel à Meta. #### Gérer les cartes * **Réordonner** — faites glisser une carte par sa poignée. Pour utiliser le clavier, placez le focus sur la poignée et appuyez sur la flèche haut ou bas. Vous pouvez aussi utiliser **Monter** et **Descendre**. * **Dupliquer** — cliquez sur **Dupliquer** pour copier une carte. Flowella copie le texte, les boutons et les exemples de variables, mais efface le média. Téléversez une nouvelle image ou vidéo sur la copie. * **Supprimer** — cliquez sur **Supprimer** pour retirer une carte. Un carrousel nécessite au moins 2 cartes. Si vous modifiez le nombre de cartes d'un modèle déjà soumis, Flowella vous avertit que le modèle repart en revue chez WhatsApp. Cliquez sur **Modifier le nombre de cartes** pour continuer ou sur **Annuler** pour conserver les cartes actuelles. #### Médias des cartes | Type de média | Formats | Taille maximale | | - | - | - | | Image | JPEG ou PNG | 5 Mo | | Vidéo | MP4 | 16 Mo | Flowella vérifie chaque fichier avant de le téléverser. Si un fichier n'est pas du bon type ou est trop volumineux, la carte affiche l'erreur immédiatement, par exemple **Cette image dépasse 5 Mo. Les images de carte JPEG et PNG doivent faire 5 Mo ou moins.** Si un téléversement échoue, cliquez sur **Réessayer** sur cette carte. WhatsApp recadre les images des cartes dans un format large. Si vous téléversez une image en portrait, Flowella vous avertit que le haut et le bas risquent d'être coupés. Utilisez des images en paysage, ou gardez le contenu important au centre. #### Règles vérifiées par Flowella avant la soumission Flowella vérifie le carrousel par rapport aux règles de WhatsApp et met en évidence la carte à corriger. Par exemple, si une carte n'a pas de média, Flowella met cette carte en évidence et affiche **Carte 3 : aucune image. Chaque carte doit avoir sa propre image téléversée avant que vous puissiez soumettre.** * Le carrousel compte de 2 à 10 cartes. * Chaque carte a un média téléversé du même type. * Soit toutes les cartes ont un texte de corps, soit aucune. Le texte du corps de carte fait 160 caractères ou moins, et chaque variable a un exemple. * Chaque carte a le même nombre de boutons, avec les mêmes types dans le même ordre. Les libellés peuvent différer. * Un bouton lien peut contenir une variable, à la fin de l'URL, avec une valeur d'exemple. Vous choisissez entre un message standard et un carrousel lors de la création du modèle. Vous ne pouvez pas transformer un carrousel en modèle standard, ni un modèle standard en carrousel. Pour changer, créez un nouveau modèle. Pour la liste complète des règles de carrousel de WhatsApp, voir [Modèles Carrousel](/fr/app/template-reference#modèles-carrousel). ## Menu d'actions du catalogue Chaque modèle du catalogue a un **menu d'actions à 3 points**, à la fois en vue grille (carte) et en vue liste (tableau). Le menu vous donne les mêmes actions dans les deux vues, donc vous n'avez plus besoin d'ouvrir l'éditeur pour les tâches courantes. | Action | Disponibilité | | - | - | | **Modifier** | Toujours. Ouvre l'éditeur de modèle. | | **Envoyer** | Modèles **Approuvés** uniquement. Désactivé sinon avec l'indication « Le modèle doit être approuvé avant l'envoi ». | | **Statistiques** | Désactivé pour les modèles **Brouillon** et **En attente**. Toujours activé pour les modèles **Approuvés**. Pour les modèles **Rejetés**, **En pause** et **Désactivés**, activé lorsque le modèle a des journaux d'envoi. | | **Cloner** | Toujours. Crée une copie comme nouveau brouillon local. | | **Copier l'ID du modèle** | Modèles qui ont été soumis à Meta. Désactivé pour les brouillons locaux avec l'indication « L'ID du modèle est disponible après la soumission de ce modèle à Meta ». | | **Soumettre pour approbation** | Affiché uniquement pour les modèles **Brouillon** et **Rejetés**. Ouvre le modèle avec la boîte de dialogue de soumission pour approbation. | | **Supprimer** | Activé pour tout sauf les [modèles de réouverture système](#system-managed-reopen-templates). Demande confirmation avant suppression. | **Envoyer** et **Statistiques** font un deep-link vers l'onglet correspondant sur la page de détail du modèle via le paramètre de requête `tab` (`?tab=send`, `?tab=statistics`), et **Soumettre pour approbation** ajoute `?submit=1` pour ouvrir la boîte de dialogue de soumission. Ces URL sont partageables — collez-en une dans un message pour envoyer un coéquipier directement sur le bon onglet. Revue des captures d'écran : la capture d'écran de la liste des modèles ci-dessus est antérieure au menu d'actions à 3 points. Mettez-la à jour lorsque de nouvelles captures seront disponibles. ### Copier l'ID de modèle Meta Une fois qu'un modèle a été soumis à Meta, il a un **ID de modèle Meta**. Vous avez besoin de cet ID pour configurer les envois API, déboguer les webhooks ou faire des références croisées avec un modèle dans Meta Business Manager. Vous pouvez le copier depuis deux endroits : * **Catalogue** — ouvrez le menu à 3 points et cliquez sur **Copier l'ID du modèle**. * **Détail du modèle** — la carte d'information dans l'en-tête de l'éditeur affiche une ligne **ID du modèle** (à côté de **Dernière mise à jour** et **Mis à jour par**) avec un bouton de copie. Les deux affichent un toast « ID du modèle copié » en cas de succès. Les brouillons locaux qui n'ont pas encore été soumis n'ont pas d'ID Meta, donc l'action est désactivée pour eux. ## Pastilles de santé de livraison sur la liste des modèles Chaque ligne de la liste des modèles peut afficher une **pastille de santé de livraison** en plus du badge de statut habituel. La pastille signale les modèles que WhatsApp a arrêté de livrer, pour que vous puissiez les repérer sans ouvrir chaque éditeur. | Pastille | Quand elle apparaît | Ce qu'elle signifie | | - | - | - | | **Mis en pause par WhatsApp** | Le statut Meta est `PAUSED`. | WhatsApp a mis ce modèle en pause. Les parcours, campagnes et actions de workflow HubSpot qui l'utilisent n'enverront pas tant que Meta ne l'a pas restauré. | | **Désactivé par WhatsApp** | Le statut Meta est `DISABLED`. | WhatsApp a désactivé ce modèle. Mettez-le à jour ou remplacez-le avant d'envoyer à nouveau. | | **Qualité : Rouge** | La note de qualité Meta est `RED` et le modèle n'est pas déjà mis en pause ou désactivé. | WhatsApp a noté ce modèle Rouge. Passez en revue les envois récents et les retours clients dans Meta Business Manager. | Les pastilles Mis en pause et Désactivé remplacent le badge de statut normal ; la pastille Qualité : Rouge s'affiche à côté. Lorsque Meta lève la pause, restaure le modèle ou ramène la qualité à Jaune/Vert, la pastille s'efface automatiquement à la prochaine synchronisation. ### Pauses de cadence vs pauses de qualité Flowella classe chaque pause Meta en deux types, et le chemin de récupération diffère : * **Pause de cadence** — WhatsApp a temporairement retenu le modèle après des retours négatifs précoces sur un envoi marketing. Flowella affiche un bouton **Reprendre** à côté de la pastille. Cliquez dessus pour demander à Meta de restaurer le modèle. Passez en revue le contenu avant de reprendre ; Flowella ne reprend jamais automatiquement. * **Pause de qualité** — WhatsApp a mis le modèle en pause pour violations de qualité. Celles-ci arrivent en instances croissantes, affichées comme **Pause qualité 1/3**, **2/3**, etc. La première pause dure environ 3 heures et la deuxième environ 6 heures ; une troisième violation désactive le modèle. Il n'y a pas de bouton Reprendre pour les pauses de qualité. Attendez que la pause expire, et ne modifiez ni ne resoumettez pendant qu'elle est active, car cela renvoie le modèle en revue Meta et prolonge la panne. Les modèles désactivés ne peuvent pas être repris depuis Flowella. Modifiez-les ou faites appel dans WhatsApp Manager. Les transitions pause, désactivation et qualité-ROUGE **déclenchent également des notifications** (`TEMPLATE_PAUSED`, `TEMPLATE_DISABLED`, `TEMPLATE_QUALITY`) pour que vous soyez au courant même si vous n'êtes pas sur la page des modèles. Optez pour ou contre dans les [Préférences de notification](/fr/settings/notification-preferences) ; la liste complète des événements est dans [Événements de notification](/fr/app/notification-events). ## Historique des statuts Meta Ouvrez n'importe quel modèle adossé à Meta et basculez sur l'onglet **Statistiques**. Sous les tuiles de journal d'envoi, vous verrez une section **Historique des statuts** qui liste chaque transition enregistrée que Meta a rapportée pour ce modèle — approbations, pauses, désactivations, changements de qualité et re-classifications de catégorie — avec un horodatage et le champ source qui a changé. Utilisez-la comme piste d'audit lorsque vous enquêtez sur une pastille de santé de livraison ou répondez à « quand ce modèle a-t-il basculé ? » dans une conversation de support. L'historique des statuts n'apparaît que pour les modèles adossés à Meta (pas les brouillons locaux) et est imbriqué dans l'onglet Statistiques. Les versions antérieures le rendaient sous la barre d'action de l'éditeur — il vit maintenant avec le reste de votre analytique de livraison. ## Modèles de réouverture gérés par le système Les modèles `flowella_reopen_*` de Flowella (Service, Update, Offer) alimentent l'[onglet Répondre](/fr/app/inbox#reply-tab-smart-reply) de la boîte de réception et le [CTA Réengager en un tap](/fr/app/inbox#one-tap-re-engage-on-a-closed-window). Dans le catalogue des modèles, ces modèles de réouverture gérés par le système portent désormais un badge **Système** à la fois en vue carte et liste pour que vous puissiez les repérer d'un coup d'œil. Vous pouvez toujours modifier le texte d'encadrement sous [Réglages → Modèles de réponse](/fr/settings/reply-templates), mais les modèles de réouverture système **ne peuvent pas être supprimés** — l'action **Supprimer** dans le menu à 3 points du catalogue et le bouton de suppression à l'intérieur de l'éditeur de modèle sont désactivés avec une info-bulle expliquant pourquoi. Pour cesser d'utiliser un type, désactivez-le dans Modèles de réponse à la place. ## Comportement de l'éditeur L'éditeur de modèle est conçu pour ne jamais perdre de travail. * **Auto-enregistrement** — chaque modification du nom, de la langue, de la catégorie, du canal ou des composants s'enregistre après une pause d'environ 1 seconde. Une barre d'action fixe en pied affiche l'état d'enregistrement actuel (**En cours d'enregistrement…**, **Enregistré** ou **Modifications non enregistrées**). * **La publication est conditionnée à l'enregistrement** — le bouton **Publier** reste désactivé jusqu'à ce que le dernier auto-enregistrement se termine, pour que vous ne puissiez jamais soumettre un brouillon à moitié enregistré à Meta. * **Les sauts de ligne du corps et les espaces du pied** sont préservés entre les changements d'onglet et les enregistrements — ce que vous tapez est ce que Meta reçoit. * **Les boutons de réponse rapide démarrent vides** avec un placeholder. Enregistrer ou publier un modèle avec un texte de réponse rapide vide est bloqué par la validation en ligne (`BUTTON_TEXT_REQUIRED`). * **La liste déroulante de catégorie** n'affiche que le libellé sélectionné lorsqu'elle est fermée ; l'ouvrir révèle les descriptions alignées Meta, une note de re-catégorisation et un lien vers la [Référence des modèles](/fr/app/template-reference). ## Tester un modèle Pour tester un modèle avant de l'utiliser avec de vrais contacts, ouvrez le modèle et basculez sur l'onglet **Envoyer**. Depuis **Modèles**, cliquez sur le modèle à tester, puis sélectionnez l'onglet **Envoyer**. Sous **Tester le modèle**, choisissez le **code pays** et saisissez le numéro WhatsApp sur lequel vous pouvez recevoir des messages. Le numéro doit être au format international avec le code pays — par exemple, `+44123456789`. Fournissez une valeur pour chaque variable de modèle. Pour les modèles **Code de coupon**, saisissez les codes littéraux que vous voulez envoyer — la valeur d'exemple du modèle est un **placeholder uniquement** et n'est jamais utilisée au moment de l'envoi. Cliquez sur **Envoyer le test**. Vous pouvez envoyer un test même pendant que le modèle est encore en attente d'approbation de Meta. Le test vous permet de voir exactement comment le message apparaîtra aux contacts avant de l'utiliser en production. Ouvrez le message sur votre appareil et confirmez que le média d'en-tête, la mise en forme du corps et les boutons s'affichent correctement. Vérifiez à la fois sur iOS et Android si possible. ### Envoyer des modèles carrousel Vous pouvez envoyer un carrousel approuvé depuis un envoi de test, un envoi en masse, la [boîte de réception](/fr/app/inbox), l'[API Flowella](/fr/api-reference/introduction) et HubSpot. * **Médias des cartes** — si vous ne fournissez pas de média pour une carte, Flowella envoie l'image ou la vidéo d'exemple approuvée de cette carte. Les envois de test, les envois en masse, les envois depuis la boîte de réception et les envois HubSpot utilisent toujours le média d'exemple approuvé. * **Valeurs par carte** — via l'API, passez une entrée `carouselCards` par carte, dans l'ordre des cartes. Chaque entrée peut définir le média de la carte (`mediaUrl` ou `mediaId`), les variables du corps de la carte (`bodyParameters`) et les valeurs des boutons (`buttonParameters`). * **Mêmes cartes pour tous les destinataires** — un envoi en masse utilise les mêmes médias et valeurs de cartes pour chaque destinataire. Les variables du corps du message peuvent toujours varier selon le destinataire. ```bash theme={null} curl -X POST "https://api.flowella.io/v1/templates/send" \ -H "Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "templateId": "clxxxxxxxxxxxxxxxxxxxxxxxx", "whatsappChannelId": "clxxxxxxxxxxxxxxxxxxxxxxxx", "recipients": [{ "phone": "+15551234567", "bodyParameters": ["Ada"] }], "carouselCards": [ { "mediaUrl": "https://cdn.example.com/card-1.jpg", "buttonParameters": [{ "index": 1, "text": "summer" }] }, { "mediaUrl": "https://cdn.example.com/card-2.jpg" } ] }' ``` Dans cet exemple, la carte 1 utilise une image personnalisée et remplit la variable à la fin du lien de son deuxième bouton avec `summer`. La carte 2 utilise une image personnalisée. L'`index` du bouton commence à zéro. ## Envoi en masse L'onglet **Envoyer** vous permet également d'envoyer un modèle **APPROUVÉ** à de nombreux destinataires en un seul job — utile pour les annonces marketing, les rappels par lots, ou tout envoi sortant structuré qui ne rentre pas dans la boîte de réception. ### Construire la liste de destinataires L'éditeur de liste de destinataires se trouve sous **Tester le modèle** dans l'onglet Envoyer. * **Ajouter des lignes manuellement** — une ligne par destinataire, avec une colonne téléphone et une colonne par variable de modèle. * **Importer un fichier** — cliquez sur **Importer un fichier** et choisissez un fichier `.csv` ou `.xlsx`. L'import de fichier est la seule façon d'ajouter des destinataires en masse ; coller des lignes n'est pas pris en charge. * **Télécharger un fichier d'exemple** — cliquez sur **Télécharger un fichier d'exemple** et choisissez **Excel (.xlsx)** ou **CSV (.csv)**. Flowella génère un fichier de démarrage avec les bons en-têtes de colonne pour le modèle sélectionné (téléphone + chaque variable). Utilisez-le comme base pour votre propre liste. * Retirez des lignes avec l'action de suppression au niveau de la ligne. Les numéros de téléphone doivent être au format international complet (`+447700900000`). Voir [Format du numéro de téléphone](/fr/hubspot/phone-number-format). #### Exigences d'import de fichier * **Formats** — `.csv` et `.xlsx` sont acceptés. Les fichiers `.xls` hérités sont rejetés ; enregistrez-les en `.xlsx` ou `.csv` d'abord. * **Limites** — les fichiers doivent faire moins de **10 Mo** et contenir au maximum **50 000 lignes de destinataires**. * **Classeurs Excel** — Flowella lit la feuille de calcul nommée **Recipients** si présente, sinon la première feuille. Les numéros de téléphone stockés comme nombres Excel s'importent en chaînes de chiffres complètes (jamais en notation scientifique), et les cellules date ou nombre s'importent telles qu'elles s'affichent dans Excel. * **Guillemets CSV** — les champs entre guillemets sont analysés selon RFC 4180, donc les virgules et retours à la ligne à l'intérieur de guillemets, les guillemets doublés (`""`) et le BOM UTF-8 de l'export « CSV UTF-8 » d'Excel fonctionnent tous. Les lignes de padding vides qu'Excel ajoute sont supprimées automatiquement. ### Planifier et throttler * **Planifier** — envoyez immédiatement, ou choisissez une date et une heure futures. * **Throttle** — choisissez combien de messages par seconde Flowella dispatche à Meta. Throttlez en dessous du **palier de limite de messagerie** de votre numéro de téléphone pour éviter des pics qui nuisent à la note de qualité. Voir [Limites d'envoi](/fr/meta/messaging-limits). ### Regarder le job s'exécuter Une fois que vous cliquez sur **Démarrer l'envoi**, l'onglet **Statistiques** du même modèle affiche une **bannière de progression** en direct et des **tuiles de récapitulatif du job** : total en file, envoyés, livrés, lus, échoués et **supprimés**. Pendant qu'un job s'exécute, la bannière et le journal d'envoi se rafraîchissent automatiquement toutes les quelques secondes. Vous n'avez pas besoin de changer d'onglet ni de remettre la fenêtre au premier plan pour voir la nouvelle progression. Si vous ouvrez l'onglet Statistiques à mi-parcours d'un job, la bannière réapparaît avec la progression en cours. L'état **Supprimé** est utilisé lorsque Flowella écarte une ligne parce que la même paire `(modèle, téléphone)` a déjà été envoyée dans la **fenêtre de déduplication**. Cela évite les doublons accidentels si vous ré-importez un fichier de destinataires ou relancez une planification. Vous pouvez quitter la page — le job continue à s'exécuter côté serveur et une notification est déclenchée lorsqu'il se termine. ### Les envois sont retenus pendant qu'un modèle est en pause ou désactivé Si vous démarrez un envoi en masse (ou déclenchez un envoi via l'API v1 ou un formulaire d'envoi HubSpot) alors que le dernier statut Meta du modèle est **En pause** ou **Désactivé**, Flowella crée le job dans un état **retenu** au lieu de le dispatcher. Rien n'est envoyé et rien n'est perdu. * **Modèles en pause** — les jobs retenus reprennent automatiquement dès que Meta restaure le modèle en Actif. Les notifications de pause/restauration de Flowella incluent combien de jobs ont été retenus et pendant combien de temps. Reprenez les pauses de cadence depuis la liste des modèles, ou attendez qu'une pause de qualité expire. * **Modèles désactivés** — les jobs retenus restent parqués. Modifiez ou faites appel du modèle dans WhatsApp Manager avant d'envoyer à nouveau. * **Les envois de test et les envois depuis la boîte de réception** sont refusés d'emblée pendant que le modèle est en pause ou désactivé, avec un toast expliquant pourquoi. Séparément, WhatsApp lui-même peut retenir un message marketing individuel pour **évaluation qualité** après l'avoir accepté. Ces lignes apparaissent comme **Retenues** dans le journal d'envoi. Si les retours précoces des destinataires sont négatifs, WhatsApp abandonne le message retenu ; il n'est pas livré et non facturé. ### Envois échoués et Renvoyer les non envoyés Si un job se termine sans avoir atteint chaque destinataire, Flowella le marque **Échoué** au lieu de rapporter un compte terminé gonflé. La bannière de progression reste visible avec le message **Envoi en masse terminé avec des destinataires non envoyés** et un bouton **Renvoyer les non envoyés**. Cliquez sur **Renvoyer les non envoyés** pour remettre en file uniquement les destinataires qui n'ont jamais reçu le message. Les destinataires déjà envoyés ne sont pas re-solicités, donc il n'y a aucun risque de doublons. ### Colonne Détails par envoi Chaque ligne du **Statistiques → Journal d'envoi** a une colonne **Détails** qui explique le résultat en langage clair au lieu d'un code d'erreur Meta. Le texte de Détails résout la raison de l'échec depuis `meta_webhook_logs` et le payload de livraison persisté, donc les échecs Meta post-envoi (par exemple, méthode de paiement **131042**) sont exposés comme les échecs de job pré-envoi. | Détail | Ce qu'il signifie | | - | - | | **Livré** | Meta a confirmé la livraison. | | **Téléphone invalide** | Le numéro de téléphone du destinataire n'est pas un numéro WhatsApp valide. | | **Opté-out** | Le contact est sur la liste d'opt-out. | | **Contact manquant** | Le téléphone n'était pas résoluble en contact Flowella au moment de l'envoi. | | **URL du média d'en-tête invalide** | Le modèle a un en-tête média dont l'URL d'exemple ne peut pas être utilisée pour les envois. Re-uploadez le média dans l'éditeur. | | **Méthode de paiement (131042)** | Meta a rejeté l'envoi car la méthode de paiement de votre WABA est invalide ou a des fonds insuffisants. | | **Abandonné après retention qualité** | WhatsApp a retenu ce message pour évaluation qualité, a reçu des retours précoces négatifs et l'a abandonné. Le message n'a pas été livré et n'a pas été facturé. | | **Autre erreur API Meta** | Un échec Meta non déterministe — renvoyez si le problème est transitoire. | | **Échec de livraison inconnu** | Meta a accepté l'envoi mais a rapporté plus tard qu'il ne pouvait pas le livrer. | Les badges de statut sont localisés dans la langue d'interface de votre compte. ## Voir aussi Catégories, en-têtes, boutons, variables et cycle de vie de soumission. Syntaxe, valeurs d'exemple, mappage HubSpot et pièges de rejet. Quels formats et tailles de médias WhatsApp accepte dans les en-têtes de modèles. Raisons courantes de rejet Meta et comment les corriger. Comment la catégorie du modèle pilote la tarification Meta par message. Envoyez vos modèles approuvés depuis un workflow HubSpot. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.