Référence des déclencheurs et actions Shopify Flow

Temps de lecture : 6 minutes. Dernière mise à jour : 15 octobre 2026 Pour qui : toute personne qui construit un workflow Flow s'appuyant sur QuotWay, ou qui évalue ce que QuotWay expose à Flow avant de s'y engager.

Voici la référence au niveau des champs. Pour construire votre premier workflow, commencez par Shopify Flow.

QuotWay expose 10 déclencheurs et 3 actions. Les déclencheurs nécessitent le forfait Professional ou supérieur ; les actions nécessitent Enterprise.

Les déclencheurs

Chaque déclencheur part d'un événement de devis et porte un ensemble plat de champs utilisables dans les conditions Flow et transmissibles aux actions suivantes.

Déclencheur	Se déclenche quand
Devis envoyé	Un acheteur envoie une demande de devis
Proposition envoyée	Vous envoyez une proposition chiffrée à l'acheteur
Contre-offre sur le devis	L'une des parties contre-propose, ouvrant un nouveau tour
Devis accepté	L'acheteur accepte, en tout ou partie
Devis refusé	L'acheteur refuse
Devis expiré	Le devis dépasse sa date d'échéance
Devis converti	Le devis devient une commande provisoire Shopify
Validation demandée	Une chaîne de validation démarre, de votre côté ou de celui de l'acheteur
Validation accordée	Une étape ou une chaîne de validation est approuvée
Validation refusée	Une étape ou une chaîne de validation est refusée

Les trois déclencheurs de validation se déclenchent pour les chaînes côté marchand et côté acheteur. Utilisez le champ Approval kind (MERCHANT ou BUYER) dans une condition Flow pour les distinguer, plutôt que d'attendre des déclencheurs séparés.

Les champs présents sur chaque déclencheur

Champ	Type	Remarques
Quote id	Texte	L'identifiant interne de QuotWay
Quote number	Texte	La référence lisible, par exemple `Q-1042`
Quote admin url	Texte	Lien direct vers le devis dans votre interface - utile dans un message Slack
Status	Texte	Le statut du devis au moment de l'événement
Mode	Texte	Le modèle de devis sous lequel tourne ce devis
Total amount	Nombre	Le total du devis
Currency code	Texte	La devise du devis
Actor type	Texte	À l'origine de l'événement : marchand, acheteur ou système
Occurred at	Texte	Horodatage ISO 8601
Customer id	Texte	L'identifiant client Shopify numérique, ou vide pour les devis sans compte
Buyer email	E-mail	Toujours présent, pour qu'une action en aval puisse écrire directement à l'acheteur

Deux remarques qui comptent quand vous construisez des conditions :

Customer id est du texte simple, pas une référence client. Les demandes de devis sans compte n'ont pas de client Shopify, et Shopify exige que chaque champ déclaré soit présent : un champ de référence ne peut pas être vide, un champ texte le peut. Un seul déclencheur couvre donc les devis avec et sans compte. Pour brancher, utilisez une condition Flow sur Customer id n'est pas vide.
Buyer email est toujours renseigné (il est validé à la demande), et c'est ce qui rend sûr de brancher une action d'e-mail directement sur n'importe quel déclencheur - y compris pour les demandes sans compte, où c'est le seul contact dont vous disposez.

Les champs supplémentaires sur certains déclencheurs

Déclencheur	Champ supplémentaire	Valeur
Contre-offre sur le devis	Round number	Réservé au numéro du tour de négociation. Vaut actuellement toujours `0`
Devis accepté	Acceptance type	`FULL` ou `PARTIAL`
Devis accepté	Accepted total	Le total accepté
Devis converti	Draft order id	Le GID de la commande provisoire
Validation demandée, accordée ou refusée	Approval kind	`MERCHANT` ou `BUYER`

Pourquoi « Devis converti » porte un identifiant de commande provisoire plutôt qu'une référence de commande. À la conversion, seule une commande provisoire existe : la vraie commande n'est créée qu'au paiement de l'acheteur. Déclarer une référence de commande qui n'existe pas encore ferait rejeter le déclencheur par Shopify ; le GID de la commande provisoire voyage donc dans un champ texte simple.

Les actions

Les actions permettent à un workflow Flow d'agir en retour sur un devis. Les trois nécessitent le forfait Enterprise.

Mettre à jour le statut du devis

Fait passer un devis à un nouveau statut.

Entrée	Obligatoire	Remarques
`quote_id`	Oui	Depuis le champ Quote id d'un déclencheur
`target_status`	Oui	L'une des valeurs `IN_REVIEW`, `DECLINED`, `EXPIRED`
`note`	Non	Consignée sur le devis

Les cibles autorisées sont volontairement étroites : rouvrir un devis pour examen, le refuser, ou le faire expirer. Les statuts qui représentent un travail à accomplir par une personne (envoyer une proposition, accepter au nom de l'acheteur) ne sont pas réglables depuis Flow.

Attribuer le devis à un membre de l'équipe

Achemine un devis vers une personne de l'équipe.

Entrée	Obligatoire	Remarques
`quote_id`	Oui	Depuis un déclencheur
`staff_email`	Oui	Comparé sans tenir compte de la casse à votre équipe QuotWay

Envoyer une notification de devis

Publie un message dans le fil du devis et envoie un e-mail à l'acheteur.

Entrée	Obligatoire	Remarques
`quote_id`	Oui	Depuis un déclencheur
`message`	Oui	Le corps du message

Ce que vous pouvez bâtir avec les seuls déclencheurs

Les déclencheurs relèvent de Professional : la plupart des workflows utiles n'ont donc pas besoin d'Enterprise.

Devis accepté au-delà de 25 000 $ → publier dans un canal Slack avec le lien direct, marquer le client d'un tag, créer une tâche.
Devis envoyé par un client portant le tag vip → prévenir immédiatement le responsable du compte.
Validation refusée → écrire au responsable des ventes avec le numéro du devis et son total.
Devis expiré → ajouter le client à un segment de relance.

Les actions ajoutent la capacité d'écrire en retour - rouvrir un devis, le réattribuer, ou écrire à l'acheteur - depuis l'intérieur d'un workflow.

Ce que Flow ne peut pas vous donner

Les déclencheurs Flow portent des champs au niveau du devis, pas le détail à la ligne. Si votre workflow a besoin des lignes, des quantités ou des prix ligne par ligne - pour synchroniser un devis dans un ERP, par exemple - cela relève de l'API QuotWay et non de Flow : elle renvoie un devis avec ses lignes, et des webhooks préviennent votre système quand un devis change. Les deux sont disponibles sur le forfait Enterprise, y compris pendant l'essai gratuit de 14 jours.