> 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/pt/integracoes/overview/integrations/shopify.md).
# Shopify
Conecte o Shopify para criar artigos e coleções ou atualizar produtos a partir de um Workflow.
A etapa de Integração com o Shopify permite-lhe ligar os seus fluxos de trabalho do AirOps diretamente à sua loja Shopify. Esta integração poderosa permite-lhe criar artigos, criar coleções personalizadas e atualizar produtos diretamente na sua loja Shopify.
### Como Configurar a Etapa de Integração com o Shopify
#### Autenticação
Antes de utilizar a integração com o Shopify nos seus fluxos de trabalho, tem primeiro de ligar a sua loja Shopify nas Definições do AirOps:
1. Navegue para ⚙ Definições > Integrações
2. Encontre a secção Shopify e clique em "Configurar"
3. Introduza o URL da sua loja Shopify (ex.: "your-store.myshopify.com")
4. Conclua o processo de autenticação OAuth, concedendo ao AirOps as permissões necessárias
O AirOps solicita `read_themes` como no `write_themes` permissões durante a autorização do Shopify. As ligações existentes mantêm as permissões anteriores até voltar a ligar. Se o acesso ao tema falhar com um 403, volte a ligar o Shopify e aprove as permissões solicitadas.
#### Tipos de ação
Selecione a ação específica do Shopify que pretende realizar:
* **Criar artigo**: Adicionar um novo artigo ao seu blogue Shopify
* **Criar coleção personalizada**: Criar uma nova coleção personalizada na sua loja Shopify
* **Atualizar produto**: Modificar um produto existente na sua loja Shopify
#### Parâmetros específicos da ação
**Criar artigo**
* **Blogue**: Selecione o blogue onde quer criar o artigo
* **Título**: O título do artigo do blogue (obrigatório)
* **Corpo (Opcional)**: O conteúdo HTML principal do artigo
* **Publicado**: Selecione se o artigo deve ser publicado
* **Autor (Opcional)**: O nome do autor do artigo
* **Modelo (Opcional)**: O sufixo do modelo Liquid usado para o artigo
* **Handle (Opcional)**: Introduza o handle do artigo
* **URL da imagem (Opcional)**: URL da imagem em destaque para o artigo
**Criar coleção personalizada**
* **Título**: Título da coleção personalizada
* **Descrição (Opcional)**: Conteúdo principal da descrição da sua coleção personalizada
* **Handle (Opcional)**: Handle da coleção personalizada
* **Itens recolhidos (Opcional)**: Introduza a lista de IDs dos produtos a recolher
* **Publicado (Opcional)**: Se a coleção deve ser publicada
* **Ordem de ordenação (Opcional)**: Ordem de ordenação da coleção personalizada
* **URL da imagem (Opcional)**: Introduza o URL da imagem da coleção personalizada
* **Texto alternativo da imagem (Opcional)**: Texto alternativo para a imagem da coleção
**Atualizar produto**
* **ID do produto**: ID do produto a atualizar
* **Título**: Título do produto
* **Corpo**: Conteúdo principal da descrição do seu produto
* **Tipo de produto**: Categoria ou tipo de produto
* **Metacampos**: Introduza a lista de metacampos
* **Etiquetas**: Introduza as etiquetas separadas por vírgulas
* **Quando a etapa falha**: Escolha terminar o fluxo de trabalho ou continuar
### Formato de Saída
A etapa de Integração com o Shopify devolve um objeto JSON com o resultado da sua ação. O formato varia consoante a ação realizada.
#### Exemplo de criação de artigo
```json
jsonCopiar{
"article": {
"id": 12345678901,
"title": "Como Otimizar o Seu Site de E-commerce para Conversões",
"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": "Saiba as estratégias essenciais para melhorar as taxas de conversão do seu e-commerce.",
"handle": "como-otimizar-o-seu-site-de-e-commerce-para-conversoes",
"tags": "otimização de conversão, dicas de e-commerce, experiência do utilizador",
"admin_graphql_api_id": "gid://shopify/Article/12345678901",
"image": {
"created_at": "2025-02-20T15:30:22Z",
"alt": "Otimização da conversão em e-commerce",
"width": 1200,
"height": 627,
"src": "https://cdn.shopify.com/s/files/1/0123/4567/8901/articles/ecommerce-conversion.jpg"
}
}
}
```
### Como Utilizar os Resultados
Pode aceder aos dados do Shopify nas etapas subsequentes do fluxo de trabalho usando a sintaxe Liquid. Por exemplo:
Para aceder ao ID de um artigo criado:
```
Copiar{{ step_2.output.article.id }}
```
Para iterar sobre uma lista de produtos num prompt de LLM:
```
Copiar{% for product in step_2.output.products %}
- {{ product.title }} ({{ product.price }})
{% endfor %}
```
### Casos de Utilização Comuns
* Criar e atualizar descrições de produtos em escala
* Gerar conteúdo de blogue otimizado para SEO para a sua loja
* Atualizar preços de produtos com base na análise de mercado
* Criar coleções de produtos personalizadas
* Construir sistemas personalizados de recomendação de produtos
* Automatizar a criação de conteúdo para promoções sazonais
### Tratamento de erros
Por predefinição, a etapa de Integração com o Shopify terminará o fluxo de trabalho se falhar. Pode configurá-la para continuar, selecionando "Continuar" em vez de "Terminar fluxo de trabalho" nas definições da etapa.
---
# 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/pt/integracoes/overview/integrations/shopify.md?ask=&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.
