Recevoir une alerte Slack sur les produits en sous-marge

Ce use case illustre une utilisation concrète du plugin Biron dans Zapier. Si vous n’êtes pas encore familier avec son fonctionnement (authentification, structure d’une requête, gestion des variables), consultez d’abord le guide Biron × Zapier avant de continuer.

---

Ce qu’on construit

Un Zap qui se déclenche chaque matin et envoie une alerte Slack si des produits vendus la veille affichent un taux de marge insuffisant. L’objectif : détecter immédiatement les anomalies de prix ou les codes promo trop agressifs avant qu’ils ne pèsent sur les résultats.

Le message Slack se compose de deux parties :

• Un message synthétique dans le channel : nombre de références concernées, réparties par niveau de gravité
• Une réponse en thread : le détail complet de chaque SKU, trié du plus critique au moins critique

---

Architecture du Zap

Schedule → Calcul des dates → Requête produits → Formatage → Slack (channel) → Slack (thread)

---

Étapes

Trigger — Schedule by Zapier

Configurez un bloc Schedule by Zapier :

• Frequency : Every Day
• Time : 9:00 AM

---

Calcul des dates

Les requêtes Biron nécessitent des dates explicites. Ce bloc génère la date d’hier dynamiquement à chaque exécution.

Ajoutez un bloc Code by Zapier (Python). Utilisez le prompt suivant pour générer le code, puis collez le résultat dans le bloc :

Rôle : Expert Python pour Zapier.
Objectif : Créer un script de calcul de dates relatives.

Calculer la date suivante en gérant les spécificités du calendrier
(années bissextiles, fins de mois) :
- Hier

Sortie : retourner un dictionnaire "output" avec la date au format YYYY-MM-DD.

---

Requête produits — taux de marge

Créez dans Biron un chart de type tableau, avec le SKU comme dimension et le taux de marge comme métrique. Appliquez un filtre de résultat pour ne conserver que les lignes avec un taux de marge inférieur à 0,45 (45 %).

Copiez le NexusQL généré et collez-le dans le bloc Biron Query de Zapier. Remplacez la date statique par la variable hier produite à l’étape précédente.

Attention

Dans le champ “If multiple search results are found”, sélectionnez “Return all results as line items” — la requête retourne une ligne par SKU concerné.

---

Formatage

Les données Biron doivent être converties en messages Slack lisibles. Ce bloc produit deux textes distincts : un résumé et un détail.

Les SKUs sont classés en trois catégories selon leur taux de marge :

Catégorie	Seuil	Emoji
Critique	Taux de marge négatif	🔴
Faible	Entre 0 % et 30 %	🟠
Moyen	Entre 30 % et 45 %	🟡

Ajoutez un bloc Code by Zapier (Python) et utilisez ce prompt pour générer le code de formatage :

Rôle : Expert Python pour Zapier.
Objectif : Formater des données pour un message Slack d'alerte.

Inputs disponibles :
- SKU
- Taux de marge

Demande :
1. Calculer le nombre total de références fournies.
2. Catégoriser chaque référence selon son taux de marge :
   - Critique : taux de marge négatif
   - Faible : entre 0 % et 30 %
   - Moyen : entre 30 % et 45 %
3. Générer un message d'alerte synthétique au format Slack indiquant
   le nombre total de références concernées et leur répartition par catégorie.
   Ne pas afficher une catégorie si elle ne contient aucune référence.
4. Générer un second message au format Slack listant tous les SKUs concernés,
   triés du plus critique au moins critique, avec pour chaque ligne :
   Emoji catégorie | Référence | Taux de marge

Les catégories sont représentées par des emojis cercles : 🔴 Critique, 🟠 Faible, 🟡 Moyen.

Note

Une fois le code collé dans le bloc, vérifiez que les noms de variables dans le code correspondent bien aux outputs du bloc Biron Query de l’étape précédente.

---

Envoi — message principal (Slack)

Ajoutez un premier bloc Slack et configurez :

• Channel : le canal où envoyer l’alerte
• Message Text : le message synthétique produit par le bloc de formatage

---

Envoi — détail en thread (Slack)

Ajoutez un second bloc Slack pour poster la liste complète en réponse du premier message :

• Channel : le même canal que l’étape précédente
• Message Text : le message détaillé produit par le bloc de formatage
• Thread : insérez la variable Ts issue du bloc Slack précédent

Attention

Pour accéder à la variable Ts, cliquez sur les trois petits points dans le champ Thread et sélectionnez Custom. Cette variable identifie le message parent auquel répondre.

---

Résultat attendu

Chaque matin à 9h, si des produits présentent un taux de marge insuffisant, votre équipe reçoit une alerte Slack structurée : un résumé immédiatement lisible dans le channel, et le détail complet accessible en thread pour ne pas polluer le fil principal.

Si aucun produit ne déclenche le filtre, le Zap ne produit aucun message.