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
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.