Déclencheur de métachamp « Boutique »

Déclencheur de métachamp « Boutique »

Copier la page

Lancez un workflow Shopify Flow dès qu'un métachamp de la boutique est modifié et récupérez l'ancienne et la nouvelle valeur.

Une boutique enregistre une seule annonce valable pour l'ensemble de l'établissement, par exemple concernant ses jours de fermeture, dans le métachamp Annonce de fermeture (custom.holiday_notice) de la boutique, et le thème l'affiche. Lorsqu'une personne modifie cette annonce, l'équipe doit voir immédiatement le nouveau texte.

Cette page explique comment lancer un workflow Shopify Flow dès qu’un métachamp de la boutique est modifié, à l’aide des extensions Workflow Trigger Extensions. Les étapes sont les mêmes pour tous les métachamps de ce type de ressource ; l’exemple utilise le métachamp Avis de fermeture pour les fêtes (custom.holiday_notice).

Ce dont vous avez besoin

  • Une définition de métachamp. Créez-la dans votre interface d'administration Shopify, sous Paramètres > Métachamps et métaobjets > Boutique. Un métachamp sans définition ne peut pas faire l'objet d'un suivi.
  • Aucune autorisation supplémentaire n'est requise. Les métachamps de la boutique peuvent être suivis dès l'installation de l'application.

1. Suivre le métachamp

  1. Ouvrez la section Déclencheurs de métachamps dans l'application, puis cliquez sur Ajouter un déclencheur.
  2. Sélectionnez le type de ressource Boutique.
  3. Cochez le métachamp intitulé Avis de fermeture pour les fêtes. Vous pouvez en cocher plusieurs à la fois ou utiliser l'option Tout sélectionner.
  4. 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.

La boîte de dialogue « Ajouter un déclencheur de métachamp » avec le type de ressource « Boutique » et le métachamp « Avis de fermeture pour les jours fériés » (custom.holiday_notice) coché
Type de ressource : Boutique, le métachamp est coché. L'option « Tous les métachamps » permet de suivre tous les métachamps de ce type.

Le déclencheur est immédiatement actif. La première fois que l'application lit la boutique, elle enregistre la valeur actuelle sans lancer un workflow ; chaque modification ultérieure en déclenche un.

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 Metafield Update dans Shopify Flow avec les valeurs suivantes :

Variable Valeur
resourceType SHOP
resourceId L'identifiant de la boutique, par exemple gid://shopify/Shop/1234567890
metafieldKey Espace de noms et clé, ici custom.holiday_notice
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

3. Mettre en place le workflow

  1. 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.
  2. Ajoutez une condition : resourceType est égal à SHOP. La mise à jour des métachamps s'effectue pour chaque type de ressource que vous suivez ; cette condition permet donc de limiter ce workflow à la boutique. Si vous suivez plusieurs métachamps de ce type, ajoutez comme deuxième critère : metafieldKey est égal à custom.holiday_notice.
  3. Ajoutez l'action souhaitée. Dans cet exemple, un e-mail interne est envoyé, indiquant l'ancienne et la nouvelle valeur.
Exemple de workflow dans Shopify Flow : mise à jour d'un métachamp, condition sur le type de ressource SHOP et envoi d'un e-mail interne
Exemple de workflow : le déclencheur, la condition liée au type de ressource et une action.

Commencez par l'exemple

  1. Téléchargez le fichier .flow joint au bas de cette page.
  2. Dans votre interface d'administration Shopify, ouvrez Shopify Flow, cliquez sur Importer et sélectionnez le fichier.
  3. Ouvrez l'étape Envoyer un e-mail interne et saisissez le destinataire. Le fichier ne contient délibérément aucune adresse.
  4. Activez le workflow.

Faites-en le vôtre

  • Utilisez metafield.previousValue et metafield.value dans l'e-mail pour afficher l'ancienne et la nouvelle notification.
  • Publiez la modification dans un chat d'équipe à l'aide de la fonction Envoyer une requête HTTP.
  • Ajoutez une condition sur metafieldKey lorsque vous effectuez le suivi de plusieurs métachamps de la boutique.

À quelle vitesse réagit-il ?

Shopify n'envoie aucune notification à ce sujet ; l'application lit donc les métachamps suivis environ une fois par minute. Le workflow devrait s'exécuter d'ici une minute ou deux.

Bon à savoir

  • Il existe une fiche par boutique ; par conséquent, l'resourceId est toujours le même.

En savoir plus