Começando
Funcionalidades
Documentação de Integração
- Integração com Asana
- Integração com Box
- Integração com ClickUp
- Integração com GitHub
- Integração com Gmail
- Integração com Google Calendar
- Integração com Google Sheets
- Integração com HubSpot
- Integração com Jira
- Integração com o Linear
- Integração com o Notion
- Integração com Salesforce
- Integração com Shopify
- Integração com Slack
- Integração Stripe
- Integração com Zendesk
Guias
Recursos
Integração com Shopify
Gestão de e-commerce e loja online com integração do Shopify para CrewAI.
Visão Geral
Permita que seus agentes gerenciem operações de e-commerce através do Shopify. Gerencie clientes, pedidos, produtos, inventário e análises da loja para otimizar sua empresa online com automação alimentada por IA.
Pré-requisitos
Antes de utilizar a integração com o Shopify, certifique-se de que você possui:
- Uma conta CrewAI Enterprise com uma assinatura ativa
- Uma loja Shopify com permissões administrativas adequadas
- Sua loja Shopify conectada através da página de Integrações
Ferramentas Disponíveis
Gerenciamento de Clientes
Descrição: Recupera uma lista de clientes da sua loja Shopify.
Parâmetros:
customerIds
(string, opcional): Lista de IDs de clientes separada por vírgula para filtrar (exemplo: “207119551, 207119552”)createdAtMin
(string, opcional): Retorna somente clientes criados após esta data (ISO ou timestamp Unix)createdAtMax
(string, opcional): Retorna somente clientes criados antes desta data (ISO ou timestamp Unix)updatedAtMin
(string, opcional): Retorna somente clientes atualizados após esta data (ISO ou timestamp Unix)updatedAtMax
(string, opcional): Retorna somente clientes atualizados antes desta data (ISO ou timestamp Unix)limit
(string, opcional): Número máximo de clientes a retornar (padrão 250)
Descrição: Pesquise por clientes usando critérios de filtragem avançados.
Parâmetros:
filterFormula
(object, opcional): Filtro avançado em forma normal disjuntiva com operadores específicos de campolimit
(string, opcional): Número máximo de clientes a retornar (padrão 250)
Descrição: Crie um novo cliente em sua loja Shopify.
Parâmetros:
firstName
(string, obrigatório): Primeiro nome do clientelastName
(string, obrigatório): Sobrenome do clienteemail
(string, obrigatório): Endereço de e-mail do clientecompany
(string, opcional): Nome da empresastreetAddressLine1
(string, opcional): EndereçostreetAddressLine2
(string, opcional): Complemento do endereçocity
(string, opcional): Cidadestate
(string, opcional): Estado ou código da provínciacountry
(string, opcional): PaíszipCode
(string, opcional): CEPphone
(string, opcional): Telefonetags
(string, opcional): Tags como array ou lista separada por vírgulanote
(string, opcional): Observação sobre o clientesendEmailInvite
(boolean, opcional): Se deve enviar convite por e-mailmetafields
(object, opcional): Metacampos adicionais em formato JSON
Descrição: Atualize um cliente existente em sua loja Shopify.
Parâmetros:
customerId
(string, obrigatório): O ID do cliente a ser atualizadofirstName
(string, opcional): Primeiro nome do clientelastName
(string, opcional): Sobrenome do clienteemail
(string, opcional): Endereço de e-mail do clientecompany
(string, opcional): Nome da empresastreetAddressLine1
(string, opcional): EndereçostreetAddressLine2
(string, opcional): Complemento do endereçocity
(string, opcional): Cidadestate
(string, opcional): Estado ou código da provínciacountry
(string, opcional): PaíszipCode
(string, opcional): CEPphone
(string, opcional): Telefonetags
(string, opcional): Tags como array ou lista separada por vírgulanote
(string, opcional): Observação sobre o clientesendEmailInvite
(boolean, opcional): Se deve enviar convite por e-mailmetafields
(object, opcional): Metacampos adicionais em formato JSON
Gestão de Pedidos
Descrição: Recupera uma lista de pedidos da sua loja Shopify.
Parâmetros:
orderIds
(string, opcional): Lista de IDs de pedidos separada por vírgula para filtrar (exemplo: “450789469, 450789470”)createdAtMin
(string, opcional): Retorna somente pedidos criados após esta data (ISO ou timestamp Unix)createdAtMax
(string, opcional): Retorna somente pedidos criados antes desta data (ISO ou timestamp Unix)updatedAtMin
(string, opcional): Retorna somente pedidos atualizados após esta data (ISO ou timestamp Unix)updatedAtMax
(string, opcional): Retorna somente pedidos atualizados antes desta data (ISO ou timestamp Unix)limit
(string, opcional): Número máximo de pedidos a retornar (padrão 250)
Descrição: Crie um novo pedido em sua loja Shopify.
Parâmetros:
email
(string, obrigatório): Endereço de e-mail do clientelineItems
(object, obrigatório): Itens do pedido em formato JSON com título, preço, quantidade e variant_idsendReceipt
(boolean, opcional): Se deve enviar recibo do pedidofulfillmentStatus
(string, opcional): Status de atendimento - Opções: fulfilled, null, partial, restockedfinancialStatus
(string, opcional): Status financeiro - Opções: pending, authorized, partially_paid, paid, partially_refunded, refunded, voidedinventoryBehaviour
(string, opcional): Comportamento de inventário - Opções: bypass, decrement_ignoring_policy, decrement_obeying_policynote
(string, opcional): Observação do pedido
Descrição: Atualize um pedido existente em sua loja Shopify.
Parâmetros:
orderId
(string, obrigatório): O ID do pedido a ser atualizadoemail
(string, opcional): Endereço de e-mail do clientelineItems
(object, opcional): Itens do pedido atualizados em formato JSONsendReceipt
(boolean, opcional): Se deve enviar recibo do pedidofulfillmentStatus
(string, opcional): Status de atendimento - Opções: fulfilled, null, partial, restockedfinancialStatus
(string, opcional): Status financeiro - Opções: pending, authorized, partially_paid, paid, partially_refunded, refunded, voidedinventoryBehaviour
(string, opcional): Comportamento de inventário - Opções: bypass, decrement_ignoring_policy, decrement_obeying_policynote
(string, opcional): Observação do pedido
Descrição: Recupera carrinhos abandonados da sua loja Shopify.
Parâmetros:
createdWithInLast
(string, opcional): Restringe os resultados para checkouts criados dentro do período especificadocreatedAfterId
(string, opcional): Restringe os resultados após o ID especificadostatus
(string, opcional): Mostra checkouts com o status especificado - Opções: open, closed (padrão open)createdAtMin
(string, opcional): Retorna somente carrinhos criados após esta data (ISO ou timestamp Unix)createdAtMax
(string, opcional): Retorna somente carrinhos criados antes desta data (ISO ou timestamp Unix)limit
(string, opcional): Número máximo de carrinhos a retornar (padrão 250)
Gestão de Produtos (REST API)
Descrição: Recupera uma lista de produtos da sua loja Shopify utilizando a REST API.
Parâmetros:
productIds
(string, opcional): Lista de IDs de produtos separada por vírgula para filtrar (exemplo: “632910392, 632910393”)title
(string, opcional): Filtrar pelo título do produtoproductType
(string, opcional): Filtrar pelo tipo de produtovendor
(string, opcional): Filtrar por fornecedorstatus
(string, opcional): Filtrar por status - Opções: active, archived, draftcreatedAtMin
(string, opcional): Retorna somente produtos criados após esta data (ISO ou timestamp Unix)createdAtMax
(string, opcional): Retorna somente produtos criados antes desta data (ISO ou timestamp Unix)updatedAtMin
(string, opcional): Retorna somente produtos atualizados após esta data (ISO ou timestamp Unix)updatedAtMax
(string, opcional): Retorna somente produtos atualizados antes desta data (ISO ou timestamp Unix)limit
(string, opcional): Número máximo de produtos a retornar (padrão 250)
Descrição: Crie um novo produto em sua loja Shopify utilizando a REST API.
Parâmetros:
title
(string, obrigatório): Título do produtoproductType
(string, obrigatório): Tipo/categoria do produtovendor
(string, obrigatório): Fornecedor do produtoproductDescription
(string, opcional): Descrição do produto (aceita texto simples ou HTML)tags
(string, opcional): Tags do produto como array ou lista separada por vírgulaprice
(string, opcional): Preço do produtoinventoryPolicy
(string, opcional): Política de estoque - Opções: deny, continueimageUrl
(string, opcional): URL da imagem do produtoisPublished
(boolean, opcional): Se o produto está publicadopublishToPointToSale
(boolean, opcional): Se deve publicar no ponto de venda
Descrição: Atualize um produto existente em sua loja Shopify utilizando a REST API.
Parâmetros:
productId
(string, obrigatório): O ID do produto a ser atualizadotitle
(string, opcional): Título do produtoproductType
(string, opcional): Tipo/categoria do produtovendor
(string, opcional): Fornecedor do produtoproductDescription
(string, opcional): Descrição do produto (aceita texto simples ou HTML)tags
(string, opcional): Tags do produto como array ou lista separada por vírgulaprice
(string, opcional): Preço do produtoinventoryPolicy
(string, opcional): Política de estoque - Opções: deny, continueimageUrl
(string, opcional): URL da imagem do produtoisPublished
(boolean, opcional): Se o produto está publicadopublishToPointToSale
(boolean, opcional): Se deve publicar no ponto de venda
Gestão de Produtos (GraphQL)
Descrição: Recupere produtos utilizando filtros avançados do GraphQL.
Parâmetros:
productFilterFormula
(object, opcional): Filtro avançado em forma normal disjuntiva com suporte a campos como id, title, vendor, status, handle, tag, created_at, updated_at, published_at
Descrição: Crie um novo produto utilizando a API GraphQL com suporte aprimorado a mídias.
Parâmetros:
title
(string, obrigatório): Título do produtoproductType
(string, obrigatório): Tipo/categoria do produtovendor
(string, obrigatório): Fornecedor do produtoproductDescription
(string, opcional): Descrição do produto (aceita texto simples ou HTML)tags
(string, opcional): Tags do produto como array ou lista separada por vírgulamedia
(object, opcional): Objetos de mídia com texto alternativo, tipo de conteúdo e URL de origemadditionalFields
(object, opcional): Campos adicionais do produto como status, requiresSellingPlan, giftCard
Descrição: Atualize um produto existente utilizando a API GraphQL com suporte aprimorado a mídias.
Parâmetros:
productId
(string, obrigatório): O ID GraphQL do produto a ser atualizado (ex.: “gid://shopify/Product/913144112”)title
(string, opcional): Título do produtoproductType
(string, opcional): Tipo/categoria do produtovendor
(string, opcional): Fornecedor do produtoproductDescription
(string, opcional): Descrição do produto (aceita texto simples ou HTML)tags
(string, opcional): Tags do produto como array ou lista separada por vírgulamedia
(object, opcional): Objetos de mídia atualizados com texto alternativo, tipo de conteúdo e URL de origemadditionalFields
(object, opcional): Campos adicionais do produto como status, requiresSellingPlan, giftCard
Exemplos de Uso
Configuração Básica do Agente Shopify
from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools
# Get enterprise tools (Shopify tools will be included)
enterprise_tools = CrewaiEnterpriseTools(
enterprise_token="your_enterprise_token"
)
# Create an agent with Shopify capabilities
shopify_agent = Agent(
role="E-commerce Manager",
goal="Manage online store operations and customer relationships efficiently",
backstory="An AI assistant specialized in e-commerce operations and online store management.",
tools=[enterprise_tools]
)
# Task to create a new customer
create_customer_task = Task(
description="Create a new VIP customer Jane Smith with email jane.smith@example.com and phone +1-555-0123",
agent=shopify_agent,
expected_output="Customer created successfully with customer ID"
)
# Run the task
crew = Crew(
agents=[shopify_agent],
tasks=[create_customer_task]
)
crew.kickoff()
Filtrando Ferramentas Específicas do Shopify
from crewai_tools import CrewaiEnterpriseTools
# Get only specific Shopify tools
enterprise_tools = CrewaiEnterpriseTools(
enterprise_token="your_enterprise_token",
actions_list=["shopify_create_customer", "shopify_create_order", "shopify_get_products"]
)
store_manager = Agent(
role="Store Manager",
goal="Manage customer orders and product catalog",
backstory="An experienced store manager who handles customer relationships and inventory management.",
tools=enterprise_tools
)
# Task to manage store operations
store_task = Task(
description="Create a new customer and process their order for 2 Premium Coffee Mugs",
agent=store_manager,
expected_output="Customer created and order processed successfully"
)
crew = Crew(
agents=[store_manager],
tasks=[store_task]
)
crew.kickoff()
Gestão de Produtos com GraphQL
from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools
enterprise_tools = CrewaiEnterpriseTools(
enterprise_token="your_enterprise_token"
)
product_manager = Agent(
role="Product Manager",
goal="Manage product catalog and inventory with advanced GraphQL capabilities",
backstory="An AI assistant that specializes in product management and catalog optimization.",
tools=[enterprise_tools]
)
# Task to manage product catalog
catalog_task = Task(
description="""
1. Create a new product "Premium Coffee Mug" from Coffee Co vendor
2. Add high-quality product images and descriptions
3. Search for similar products from the same vendor
4. Update product tags and pricing strategy
""",
agent=product_manager,
expected_output="Product created and catalog optimized successfully"
)
crew = Crew(
agents=[product_manager],
tasks=[catalog_task]
)
crew.kickoff()
Análise de Pedidos e Clientes
from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools
enterprise_tools = CrewaiEnterpriseTools(
enterprise_token="your_enterprise_token"
)
analytics_agent = Agent(
role="E-commerce Analyst",
goal="Analyze customer behavior and order patterns to optimize store performance",
backstory="An analytical AI that excels at extracting insights from e-commerce data.",
tools=[enterprise_tools]
)
# Complex task involving multiple operations
analytics_task = Task(
description="""
1. Retrieve recent customer data and order history
2. Identify abandoned carts from the last 7 days
3. Analyze product performance and inventory levels
4. Generate recommendations for customer retention
""",
agent=analytics_agent,
expected_output="Comprehensive e-commerce analytics report with actionable insights"
)
crew = Crew(
agents=[analytics_agent],
tasks=[analytics_task]
)
crew.kickoff()
Precisa de Ajuda?
Precisa de Ajuda?
Entre em contato com nossa equipe de suporte para assistência na configuração ou resolução de problemas de integração com o Shopify.
Esta página foi útil?
- Visão Geral
- Pré-requisitos
- Ferramentas Disponíveis
- Gerenciamento de Clientes
- Gestão de Pedidos
- Gestão de Produtos (REST API)
- Gestão de Produtos (GraphQL)
- Exemplos de Uso
- Configuração Básica do Agente Shopify
- Filtrando Ferramentas Específicas do Shopify
- Gestão de Produtos com GraphQL
- Análise de Pedidos e Clientes
- Precisa de Ajuda?