> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livyapps.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Automatise avec Shopify Flow
Shopify Flow est l'application d'automatisation de Shopify : elle te permet de créer des règles du type "quand ceci arrive, fais cela", sans écrire de code. Livy se connecte à Flow et y ajoute deux briques : une **étape** pour ajuster les points (Adjust Livy points) et un **déclencheur** qui prévient quand Livy ajoute des points (Livy points awarded).
Tu peux ainsi récompenser les clients que tu étiquettes VIP, retirer des points lors d'un remboursement, ou prévenir ton équipe sur Slack chaque fois que quelqu'un gagne des points.
## Avant de commencer
* Ton forfait Livy doit être **Starter ou supérieur**. Le forfait Free n'inclut pas cette intégration.
* Il te faut l'application **Shopify Flow** installée. Elle est gratuite et publiée par Shopify.
Dans Livy, tu vois l'état de cette intégration dans **Configurations > Shopify Flow**.
## L'étape : Adjust Livy points
Tu l'ajoutes comme action dans n'importe quel workflow. Elle ajoute ou retire des points à un client.
| Champ | Ce que c'est |
| ---------- | ------------------------------------------------------------------------------------- |
| **Client** | À qui les points sont ajustés. |
| **Points** | Nombre entier non nul. Positif ajoute, négatif soustrait. |
| **Reason** | Facultatif, jusqu'à 400 caractères. Conservé dans la transaction de points du client. |
### C'est le signe qui décide
Un nombre **positif** ajoute. Un nombre **négatif** retire. Le `0` est refusé, car un ajustement de zéro point n'est pas un ajustement.
**Si le solde du client ne suffit pas, on retire jusqu'à ce qu'il soit épuisé et le workflow reste en succès.** Si tu demandes de retirer 500 et que le client en a 100, ces 100 sont retirés et le solde tombe à zéro : il ne reste jamais de points en négatif et Flow ne marque pas l'étape comme échouée.
C'est volontaire. Le cas normal d'un retrait est de sanctionner un remboursement, et le client a souvent déjà dépensé ses points. Échouer reviendrait à échouer précisément quand tu veux le plus récupérer.
## Le déclencheur : Livy points awarded
Tu l'utilises pour démarrer un workflow. Il se déclenche quand Livy ajoute des points.
| Champ | Ce qu'il transporte |
| ------------------ | ---------------------------------------------------------------------------------- |
| **Client** | Qui a reçu les points. |
| **Points awarded** | Combien de points ont été attribués. |
| **Points balance** | Le solde du client après l'attribution. |
| **Source** | `order` s'ils viennent d'un achat, `earn_rule` s'ils viennent d'une règle de gain. |
| **Rule** | Le type de règle qui les a attribués. Vide quand `Source` vaut `order`. |
Les noms de ces champs sont en anglais car Shopify ne les traduit pas : c'est exactement ce que tu verras dans le sélecteur de variables de l'éditeur Flow.
### Quand il ne se déclenche PAS
* Quand tu ajustes des points à la main depuis l'admin Livy.
* Quand tu importes ton historique de clients ou de commandes.
* Quand les points viennent de l'étape Flow elle-même.
Ce dernier point est le plus important : sans cette règle, un workflow qui attribue des points se déclencherait lui-même en boucle.
## Exemples
### Récompenser un client VIP
### Retirer des points lors d'un remboursement
C'est ce cas qui justifie que l'étape ajuste au lieu de seulement attribuer.
### Prévenir l'équipe quand quelqu'un gagne des points via une règle
## Si quelque chose échoue
Flow t'affiche la raison dans l'historique du workflow. Voici les messages que Livy peut renvoyer.
**Les messages sont en anglais**, copiés tels que Flow les affiche, pour que tu puisses chercher ici celui que tu vois. L'explication de ce qu'il faut faire est à côté.
| Message | Que faire |
| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| Your current plan does not include the Shopify Flow integration. Upgrade to Starter or higher. | Change de forfait dans **Configurations > Abonnement et utilisation**. |
| Your Livy subscription is not active. Check the plan in the app to resume it. | Ton abonnement est en pause ou résilié. Reprends-le depuis l'application. |
| Your loyalty program is paused in Livy. | Réactive ton programme dans Livy. |
| You reached the order limit of your plan for this month. | Attends la période suivante ou passe à un forfait supérieur. |
| Points must be a whole number other than zero. Positive adds, negative subtracts. | Corrige le champ **Points** de l'étape. |
| The reason cannot be longer than 400 characters. | Raccourcis le champ **Reason**. |
| That customer has no email in Shopify, and Livy needs one to track their points. | Ajoute un e-mail à ce client dans Shopify. |
| We could not find that customer in Shopify. | Le client a été supprimé. Vérifie le déclencheur du workflow. |
| The step did not receive a customer. Check that the workflow trigger delivers one. | Ton déclencheur ne fournit pas de client. Prends-en un qui le fait. |
| We could not find your store in Livy. Reinstall the app and try again. | Réinstalle Livy. |
| Livy is uninstalled on this store. | Installe Livy à nouveau. |
### L'étape se réessaie toute seule
Si le problème est passager (Livy ne répond pas un instant), Flow réessaie l'étape pendant des heures, sans que tu fasses quoi que ce soit. Les messages du tableau ci-dessus sont ceux qui ne se règlent **pas** tout seuls : là, Flow s'arrête et te les montre.
### Relancer un workflow ne double pas les points
Chaque exécution a son identifiant. Si Flow réessaie la même, Livy le reconnaît et n'ajuste pas une seconde fois.
***
#### Livy, nous le créons tous ensemble.
N'hésitez pas à nous écrire si vous avez besoin d'aide ou si vous avez une suggestion. Vous pouvez le faire à [info@livyapps.com](mailto:info@livyapps.com). Nous sommes là pour vous aider.