Déclencheur de métachamp « Commande »
Déclenchez un workflow Shopify Flow quand un métachamp de commande change, et récupérez l'ancienne et la nouvelle valeur avec Workflow Trigger Extensions.
Un client demande à l'assistance d'ajouter un message d'accompagnement après avoir passé sa commande. L'assistance l'inscrit dans le métachamp Message d'accompagnement (custom.gift_message) de la commande, et l'équipe chargée de la préparation des colis doit le consulter avant l'expédition du colis.
Cette page explique comment déclencher un workflow Shopify Flow dès qu’un métachamp d’une commande est modifié, à l’aide des extensions Workflow Trigger Extensions. Les étapes sont identiques pour tous les métachamps de ce type de ressource ; l’exemple utilise le métachamp Message d’accompagnement du cadeau (custom.gift_message).
Ce dont vous avez besoin
- Un métachamp. Créez-le dans votre interface d'administration Shopify, sous Paramètres > Métachamps et métaobjets > Commandes. Un métachamp sans définition ne peut pas faire l'objet d'un suivi.
- L'autorisation Accès aux données. Veuillez l'activer sur la page Autorisations de l'application ; pour plus d'informations, consultez Autorisations et accès aux données.
1. Suivre le métachamp
- Ouvrez la section Déclencheurs de métachamps dans l'application, puis cliquez sur Ajouter un déclencheur.
- Sélectionnez le type de ressource Commande.
- Cochez le métachamp Message d'accompagnement. Vous pouvez en cocher plusieurs à la fois ou utiliser l'option Tout sélectionner.
- Cliquez sur Ajouter un déclencheur.
Pour suivre tous les métachamps de ce type de ressource, y compris ceux que vous créerez ultérieurement, sélectionnez Tous les métachamps au lieu de cocher chacun d'entre eux individuellement, puis cliquez sur Suivre tous les métachamps.

Le nouveau déclencheur affiche Initialisation pendant que l'application lit la valeur actuelle du métachamp sur vos commandes existantes, puis Actif. C'est grâce à cette première lecture que la toute première modification s'accompagne d'emblée de la bonne valeur précédente.
Si le métachamp ne figure pas dans la liste, cliquez sur Actualiser les métachamps sur la page « Déclencheurs de métachamps » : l'application conserve la liste des définitions pendant une heure.
2. Ce que reçoit le workflow
Chaque modification déclenche l'événement Métachamp Update dans Shopify Flow avec les valeurs suivantes :
| Variable | Valeur |
|---|---|
resourceType |
ORDER |
resourceId |
L'identifiant de la commande, par exemple gid://shopify/Order/1234567890 |
metafieldKey |
Espace de noms et clé, ici custom.gift_message |
metafield.value |
La nouvelle valeur |
metafield.previousValue |
La valeur avant la modification ; vide lorsque le métachamp a été défini pour la première fois |
metafield.type |
Le type du métachamp, par exemple single_line_text_field |
Mise à jour du métachamp de la commande est un deuxième déclencheur pour la même modification. Il se lance en complément de « Mise à jour du métachamp » et intègre la commande en tant que référence native de Shopify Flow ; ainsi, les actions propres à Shopify relatives à la commande s’appliquent directement, sans étape de recherche. Les deux partagent un même événement ; leur utilisation simultanée n’est donc pas comptabilisée deux fois. Activez-le depuis la page Déclencheurs de l’application, ou activez un workflow qui l’utilise.
3. Mettre en place le workflow
- Dans Shopify Flow, créez un workflow et sélectionnez le déclencheur Mise à jour du métachamp parmi les extensions de déclencheurs de Workflow Trigger Extensions.
- Ajoutez une condition :
resourceTypeest égal àORDER. La mise à jour des métachamps s'applique à chaque type de ressource que vous suivez ; cette condition permet donc de limiter ce workflow aux commandes. Si vous suivez plusieurs métachamps de ce type, ajoutez comme deuxième critère :metafieldKeyest égal àcustom.gift_message. - Ajoutez l'action souhaitée. Dans cet exemple, un e-mail interne est envoyé, indiquant l'ancienne et la nouvelle valeur.

Commencez par l'exemple
- Téléchargez le fichier
.flowjoint au bas de cette page. - Dans votre interface d'administration Shopify, ouvrez Shopify Flow, cliquez sur Importer et sélectionnez le fichier.
- Ouvrez l'étape Envoyer un e-mail interne et saisissez le destinataire. Le fichier ne contient délibérément aucune adresse.
- Activez le workflow.
Faites-en le vôtre
- Ajouter une balise à la commande : sélectionnez l'action Ajouter des balises à la commande et insérez
{{resourceId}}dans le champ correspondant. - Ajoutez la condition «
metafield.valuen'est pas vide » afin qu'un message supprimé n'envoie rien. - Utilisez la mise à jour du métachamp Commande lorsque le workflow doit lire les articles ou l'adresse de livraison.
À quelle vitesse réagit-il ?
Shopify informe l'application lorsqu'une commande est enregistrée ; le workflow se lance donc généralement en quelques secondes.
Bon à savoir
- Par défaut, l'application surveille les commandes créées au cours des 60 derniers jours. Pour les commandes plus anciennes, il est nécessaire d'activer l'accès complet à l'historique des commandes sur la page « Autorisations » et de définir une période plus longue dans les paramètres d'historique des commandes de l'application.
En savoir plus
- Déclencheurs de métachamps : fonctionnement des déclencheurs de métachamps, pour chaque type de ressource.
- Déclencher une Shopify Flow lors des mises à jour des méchamps de commande : un exemple concret accompagné d'une vidéo.
- Historique des événements et dépannage : consultez tous les événements envoyés par l'application, avec l'ancienne et la nouvelle valeur.
