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 AMP com uma assinatura ativa
- Uma loja Shopify com permissões administrativas adequadas
- Sua loja Shopify conectada através da página de Integrações
Configurando a Integração Shopify
1. Conecte sua Loja Shopify
- Acesse CrewAI AMP Integrações
- Encontre Shopify na seção Integrações de Autenticação
- Clique em Conectar e complete o fluxo OAuth
- Conceda as permissões necessárias para gerenciamento de loja e produtos
- Copie seu Token Enterprise em Configurações de Integração
2. Instale o Pacote Necessário
3. Configuração de variável de ambiente
Para usar integrações com
Agent(apps=[]), você deve definir a variável de ambiente CREWAI_PLATFORM_INTEGRATION_TOKEN com seu Enterprise Token..env:
Ferramentas Disponíveis
Gerenciamento de Clientes
shopify/get_customers
shopify/get_customers
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)
shopify/search_customers
shopify/search_customers
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)
shopify/create_customer
shopify/create_customer
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
shopify/update_customer
shopify/update_customer
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
shopify/get_orders
shopify/get_orders
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)
shopify/create_order
shopify/create_order
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
shopify/update_order
shopify/update_order
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
shopify/get_abandoned_carts
shopify/get_abandoned_carts
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)
shopify/get_products
shopify/get_products
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)
shopify/create_product
shopify/create_product
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
shopify/update_product
shopify/update_product
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)
shopify/get_products_graphql
shopify/get_products_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
shopify/create_product_graphql
shopify/create_product_graphql
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
shopify/update_product_graphql
shopify/update_product_graphql
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
Filtrando Ferramentas Específicas do Shopify
Gestão de Produtos com GraphQL
Análise de Pedidos e Clientes
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.
