> ## 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.
# Automatiza con Shopify Flow
Shopify Flow es la app de automatizaciones de Shopify: te deja armar reglas del tipo "cuando pase esto, haz esto otro", sin escribir código. Livy se conecta con Flow y suma dos piezas: un **paso** para ajustar puntos (Adjust Livy points) y un **disparador** que avisa cuando Livy suma puntos (Livy points awarded).
Con eso puedes premiar a quien etiquetas como VIP, descontar puntos cuando te devuelven un pedido, o avisar a tu equipo en Slack cada vez que alguien gana puntos.
## Antes de empezar
* Tu plan de Livy tiene que ser **Starter o superior**. El plan Free no incluye esta integración.
* Necesitas la app **Shopify Flow** instalada en tu tienda. Es gratuita y la publica Shopify.
En Livy ves el estado de esta integración en **Configuraciones > Shopify Flow**.
## El paso: Adjust Livy points
Lo agregas como acción en cualquier workflow. Suma o resta puntos a un cliente.
| Campo | Qué es |
| ----------- | --------------------------------------------------------------------------------------- |
| **Cliente** | A quién se le ajustan los puntos. |
| **Points** | Número entero distinto de cero. Positivo suma, negativo resta. |
| **Reason** | Opcional, hasta 400 caracteres. Queda guardado en la transacción de puntos del cliente. |
### El signo es lo que decide
Un número **positivo suma**. Uno **negativo resta**. El `0` se rechaza, porque un ajuste de cero puntos no es un ajuste.
**Si el cliente no tiene saldo suficiente, se descuenta hasta donde alcanza y el workflow figura como exitoso.** Si pides restar 500 y el cliente tiene 100, se le descuentan esos 100 y queda en cero: no queda debiendo puntos y Flow no marca el paso como fallido.
Es a propósito. El caso normal de una resta es penalizar una devolución, y ahí muchas veces el cliente ya gastó los puntos. Fallar sería fallar justo cuando más te importa cobrar.
## El disparador: Livy points awarded
Lo usas como inicio de un workflow. Se dispara cuando Livy suma puntos.
| Campo | Qué trae |
| ------------------ | ----------------------------------------------------------------------------- |
| **Cliente** | Quién recibió los puntos. |
| **Points awarded** | Cuántos puntos se otorgaron. |
| **Points balance** | El saldo del cliente después del otorgamiento. |
| **Source** | `order` si vienen de una compra, `earn_rule` si vienen de una forma de ganar. |
| **Rule** | El tipo de regla que los otorgó. Vacío cuando `Source` es `order`. |
Los nombres de estos campos están en inglés porque Shopify no los traduce: son los que vas a ver en el selector de variables del editor de Flow.
### Cuándo NO se dispara
* Cuando ajustas puntos a mano desde el panel de Livy.
* Cuando importas tu historial de clientes o de pedidos.
* Cuando los puntos los suma el propio paso de Flow.
Ese último es el que más importa: sin esa regla, un workflow que otorga puntos se dispararía a sí mismo en bucle.
## Ejemplos
### Premiar a un cliente VIP
### Descontar puntos por una devolución
Este es el caso que justifica que el paso sea de ajuste y no solo de suma.
### Avisar al equipo cuando alguien gana puntos por una regla
## Si algo falla
Flow te muestra el motivo en el historial del workflow. Estos son los mensajes que puede darte Livy.
| Mensaje | Qué hacer |
| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| Your current plan does not include the Shopify Flow integration. Upgrade to Starter or higher. | Cambia de plan desde **Configuraciones > Suscripción y uso**. |
| Your Livy subscription is not active. Check the plan in the app to resume it. | Tu suscripción está pausada o cancelada. Reanúdala desde la app. |
| Your loyalty program is paused in Livy. | Vuelve a activar el programa desde Livy. |
| You reached the order limit of your plan for this month. | Espera al próximo período o amplía tu plan. |
| Points must be a whole number other than zero. Positive adds, negative subtracts. | Corrige el campo **Points** del paso. |
| The reason cannot be longer than 400 characters. | Acorta el campo **Reason**. |
| That customer has no email in Shopify, and Livy needs one to track their points. | Agrega un email a ese cliente en Shopify. |
| We could not find that customer in Shopify. | El cliente fue borrado. Revisa el disparador del workflow. |
| The step did not receive a customer. Check that the workflow trigger delivers one. | El disparador que elegiste no entrega un cliente. Usa uno que sí lo haga. |
| We could not find your store in Livy. Reinstall the app and try again. | Reinstala Livy. |
| Livy is uninstalled on this store. | Vuelve a instalar Livy. |
Los mensajes están copiados tal cual los muestra Flow, para que puedas buscar aquí el que te aparezca.
### El paso se reintenta solo
Si el problema es pasajero (Livy no responde un momento), Flow reintenta el paso durante horas, sin que hagas nada. Los mensajes de la tabla de arriba son los que **no** se arreglan solos: ahí Flow corta y te lo muestra.
### Repetir un workflow no duplica los puntos
Cada ejecución tiene su identificador. Si Flow reintenta la misma, Livy la reconoce y no vuelve a ajustar.
***
#### Livy lo creamos entre todos.
No dudes en escribirnos si necesitas ayuda o tienes una sugerencia. Puedes hacerlo a [info@livyapps.com](mailto:info@livyapps.com). Estamos para ayudarte.