> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/integraciones/overview/integrations/shopify.md).

# Shopify

Conecta Shopify para crear artículos y colecciones o actualizar productos desde un flujo de trabajo.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-834bf9e741b2f104fddda7470ed9879d21ed8bb9%2Fshopify-step-01-create-article.png?alt=media" alt="Shopify Integration step creating an article in the News blog with a title, a body, and Published set to True"><figcaption><p>Crear un artículo de Shopify a partir de un flujo de trabajo.</p></figcaption></figure>

El paso de integración de Shopify te permite conectar tus flujos de trabajo de AirOps directamente con tu tienda de Shopify. Esta potente integración te permite crear artículos, crear colecciones personalizadas y actualizar productos directamente en tu tienda de Shopify.

### Cómo configurar el paso de integración de Shopify

#### Autenticación

Antes de usar la integración de Shopify en tus flujos de trabajo, primero debes conectar tu tienda de Shopify en la configuración de AirOps:

1. Ve a ⚙ Configuración > Integraciones
2. Busca la sección de Shopify y haz clic en "Configurar"
3. Introduce la URL de tu tienda de Shopify (por ejemplo, "tu-tienda.myshopify.com")
4. Completa el proceso de autenticación OAuth concediendo a AirOps los permisos necesarios

AirOps solicita `read_themes` como en el `write_themes` permisos durante la autorización de Shopify. Las conexiones existentes conservan sus permisos anteriores hasta que vuelvas a conectarlas. Si el acceso al tema falla con un 403, vuelve a conectar Shopify y aprueba los permisos solicitados.

#### Tipos de acción

Selecciona la acción específica de Shopify que quieres realizar:

* **Crear artículo**: Añade un nuevo artículo a tu blog de Shopify
* **Crear colección personalizada**: Crea una nueva colección personalizada en tu tienda de Shopify
* **Actualizar producto**: Modifica un producto existente en tu tienda de Shopify

#### Parámetros específicos de la acción

**Crear artículo**

* **Blog**: Selecciona el blog donde quieres crear el artículo
* **Título**: El título del artículo del blog (obligatorio)
* **Cuerpo (opcional)**: El contenido HTML principal del artículo
* **Publicado**: Selecciona si el artículo debe publicarse
* **Autor (opcional)**: El nombre del autor del artículo
* **Plantilla (opcional)**: El sufijo de la plantilla Liquid utilizada para el artículo
* **Handle (opcional)**: Introduce el handle del artículo
* **URL de la imagen (opcional)**: URL de la imagen destacada del artículo

**Crear colección personalizada**

* **Título**: Título de la colección personalizada
* **Descripción (opcional)**: Contenido principal de la descripción de tu colección personalizada
* **Handle (opcional)**: Handle de la colección personalizada
* **Collects (opcional)**: Introduce la lista de IDs de productos para recopilar
* **Publicado (opcional)**: Si la colección debe publicarse
* **Orden de clasificación (opcional)**: Orden de clasificación de la colección personalizada
* **URL de la imagen (opcional)**: Introduce la URL de la imagen de la colección personalizada
* **Texto alternativo de la imagen (opcional)**: Texto alternativo para la imagen de la colección

**Actualizar producto**

* **ID del producto**: ID del producto que se va a actualizar
* **Título**: Título del producto
* **Cuerpo**: Contenido principal de la descripción de tu producto
* **Tipo de producto**: Categoría o tipo de producto
* **Metacampos**: Introduce la lista de metacampos
* **Etiquetas**: Introduce las etiquetas separadas por comas
* **Cuando el paso falla**: Elige terminar el flujo de trabajo o continuar

### Formato de salida

El paso de integración de Shopify devuelve un objeto JSON con el resultado de tu acción. El formato varía según la acción realizada.

#### Ejemplo de crear artículo

```json
jsonCopiar{
  "article": {
    "id": 12345678901,
    "title": "Cómo optimizar tu sitio de comercio electrónico para conversiones",
    "author": "Jane Smith",
    "blog_id": 23456789012,
    "created_at": "2025-02-20T15:30:22Z",
    "updated_at": "2025-02-20T15:30:22Z",
    "published_at": "2025-02-20T15:30:22Z",
    "summary_html": "Aprende las estrategias esenciales para mejorar las tasas de conversión de tu comercio electrónico.",
    "handle": "como-optimizar-tu-sitio-de-comercio-electronico-para-conversiones",
    "tags": "optimización de conversiones, consejos de comercio electrónico, experiencia de usuario",
    "admin_graphql_api_id": "gid://shopify/Article/12345678901",
    "image": {
      "created_at": "2025-02-20T15:30:22Z",
      "alt": "Optimización de conversiones en comercio electrónico",
      "width": 1200,
      "height": 627,
      "src": "https://cdn.shopify.com/s/files/1/0123/4567/8901/articles/ecommerce-conversion.jpg"
    }
  }
}
```

### Cómo usar los resultados

Puedes acceder a los datos de Shopify en pasos posteriores del flujo de trabajo usando sintaxis Liquid. Por ejemplo:

Para acceder al ID de un artículo creado:

```
Copiar{{ step_2.output.article.id }}
```

Para iterar sobre una lista de productos en un prompt de LLM:

```
Copiar{% for product in step_2.output.products %}
- {{ product.title }} ({{ product.price }})
{% endfor %}
```

### Casos de uso comunes

* Crear y actualizar descripciones de productos a gran escala
* Generar contenido de blog optimizado para SEO para tu tienda
* Actualizar los precios de los productos según el análisis de mercado
* Crear colecciones de productos personalizadas
* Crear sistemas personalizados de recomendación de productos
* Automatizar la creación de contenido para promociones de temporada

### Manejo de errores

De forma predeterminada, el paso de integración de Shopify terminará el flujo de trabajo si falla. Puedes configurarlo para que continúe seleccionando "Continuar" en lugar de "Terminar flujo de trabajo" en la configuración del paso.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/integraciones/overview/integrations/shopify.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
