Pular para conteúdo

Integração Shopify - Lumina Flow Builder

Visão Geral

A integração Shopify no Lumina Flow Builder permite automação completa de e-commerce, conectando sua loja Shopify ao WhatsApp e outros canais para criar experiências de vendas automatizadas e personalizadas.

O que você pode fazer com esta integração?

Produtos

  • Criar produtos automaticamente via flows
  • Buscar informações de produtos (preço, estoque)
  • Atualizar preços e estoque em tempo real
  • Deletar produtos obsoletos
  • Listar catálogo completo

Pedidos

  • Consultar status de pedidos para clientes
  • Listar pedidos pendentes de envio
  • Cancelar pedidos solicitados por clientes
  • Marcar pedidos como enviados com rastreamento
  • Gerar relatórios de vendas

Clientes

  • Criar clientes via WhatsApp
  • Buscar dados de clientes por email/nome
  • Atualizar informações de contato
  • Segmentar clientes por tags

Casos de Uso Práticos

1. Atendimento via WhatsApp

Cliente pergunta sobre status do pedido: - Cliente envia número do pedido - Bot busca pedido no Shopify - Retorna status de pagamento e envio - Envia código de rastreamento

2. Vendas Conversacionais

Vendedor cadastra produtos via WhatsApp: - Vendedor informa nome e preço - Bot cria produto no Shopify - Produto fica disponível na loja instantaneamente

3. Gestão de Estoque

Atualização automática após vendas: - Venda confirmada - Flow atualiza estoque no Shopify - Se estoque zerou, desativa produto automaticamente

4. Campanhas de Marketing

Cadastro de leads via WhatsApp: - Cliente se cadastra via WhatsApp - Bot cria cliente no Shopify - Cliente recebe ofertas segmentadas por tags

5. Logística Automatizada

Registro de envios: - Sistema detecta pedidos prontos para envio - Integração com transportadora gera rastreamento - Bot marca pedido como enviado no Shopify - Cliente recebe notificação automática

Configuração

Pré-requisitos

  1. Loja Shopify Ativa
  2. Plano Shopify (Basic, Shopify ou Advanced)

  3. Acesso ao Admin

  4. API Access Token

  5. Acesse: Shopify Admin → Apps → Develop apps
  6. Crie uma Private App ou Custom App

  7. Copie o Admin API access token (começa com shpat_)

  8. Permissões Necessárias

  9. read_products e write_products (gerenciar produtos)
  10. read_orders e write_orders (gerenciar pedidos)
  11. read_customers e write_customers (gerenciar clientes)

Parâmetros de Configuração

Todos os nodes Shopify requerem:

{
  "config": {
    "shopName": "minhaloja",
    "accessToken": "shpat_xxxxxxxxxxxxx",
    "apiVersion": "2025-01"
  }
}
Parâmetro Descrição Exemplo
shopName Nome da loja (sem .myshopify.com) "minhaloja"
accessToken Token de acesso da API "shpat_abc123..."
apiVersion Versão da API (opcional) "2025-01"

Operações Disponíveis

Produtos (Products)

Operação Arquivo Descrição
CREATE product-create.md Criar novo produto
GET product-get.md Buscar produto por ID
UPDATE product-update.md Atualizar produto existente
DELETE product-delete.md Deletar produto
LIST product-list.md Listar múltiplos produtos

Pedidos (Orders)

Operação Arquivo Descrição
GET order-get.md Buscar pedido por ID
LIST order-list.md Listar pedidos (filtros)
CANCEL order-cancel.md Cancelar pedido
FULFILL order-fulfill.md Marcar como enviado

Clientes (Customers)

Operação Arquivo Descrição
CREATE customer-create.md Criar novo cliente
GET customer-get.md Buscar cliente por ID
UPDATE customer-update.md Atualizar cliente
SEARCH customer-search.md Buscar por email/nome

Exemplos de Flows Completos

Exemplo 1: Catálogo de Produtos via WhatsApp

Objetivo: Cliente navega pelo catálogo e recebe detalhes dos produtos.

Cliente: Oi
Bot: Bem-vindo! Veja nossos produtos:
     1. Camiseta Básica - R$ 49,90
     2. Tênis Nike - R$ 299,90
     3. Calça Jeans - R$ 159,90
Cliente: 2
Bot: Tênis Nike Air
     Preço: R$ 299,90
     Estoque: 25 unidades
     Descrição: Tênis para corrida...

Nodes usados: SHOPIFY PRODUCT LIST → LOOP → MESSAGE → NUMBER → SHOPIFY PRODUCT GET

Exemplo 2: Rastreamento de Pedido

Objetivo: Cliente consulta status do pedido enviando número.

Cliente: Onde está meu pedido?
Bot: Digite o número do pedido:
Cliente: 1234
Bot: Pedido #1234
     Status Pagamento: Pago ✅
     Status Envio: Em trânsito 🚚
     Código Rastreamento: BR123456789BR
     Previsão: 3 dias úteis

Nodes usados: INPUT → SHOPIFY ORDER GET → MESSAGE

Exemplo 3: Cancelamento Automatizado

Objetivo: Cancelar pedidos não pagos após 24 horas.

Sistema: [Executa diariamente]
         Lista pedidos pendentes
         Verifica data de criação
         Se > 24h e pagamento pending:
           Cancela pedido
           Envia email ao cliente
           Restaura estoque

Nodes usados: SHOPIFY ORDER LIST → LOOP → CONDITION → SHOPIFY ORDER CANCEL → MESSAGE

Exemplo 4: Cadastro de Cliente

Objetivo: Cadastrar cliente via WhatsApp antes da primeira compra.

Bot: Bem-vindo! Para continuar, preciso de alguns dados.
Bot: Qual é o seu nome completo?
Cliente: João Silva
Bot: Digite seu email:
Cliente: joao@example.com
Bot: Digite seu telefone:
Cliente: 11999999999
Bot: ✅ Cadastro concluído!
     Você receberá nossas ofertas exclusivas!

Nodes usados: MESSAGE → INPUT → EMAIL → PHONE → SHOPIFY CUSTOMER CREATE

Exemplo 5: Notificação de Envio

Objetivo: Notificar cliente automaticamente quando pedido for despachado.

Sistema: [Webhook de transportadora]
         Pedido coletado → Gera código rastreamento

Flow:    Busca pedido no Shopify
         Marca como enviado
         Registra código rastreamento

WhatsApp → Cliente: Seu pedido foi enviado!
                    Código: BR123456789BR
                    Link: [rastreamento]

Nodes usados: SHOPIFY ORDER GET → SHOPIFY ORDER FULFILL → MESSAGE (WhatsApp)

Boas Práticas

Segurança

✅ SIM: - Armazene accessToken em variáveis de ambiente (nunca hardcode) - Use HTTPS para todas as requisições - Implemente autenticação no WhatsApp antes de operações sensíveis - Registre logs de todas as operações

❌ NÃO: - Não exponha accessToken em logs ou mensagens - Não permita operações de deleção sem confirmação - Não armazene dados sensíveis de clientes em variáveis globais

Performance

✅ SIM: - Use delays entre requisições em massa (rate limiting) - Cache dados de produtos que não mudam frequentemente - Use SHOPIFY PRODUCT LIST com limit apropriado - Implemente paginação para listas grandes

❌ NÃO: - Não faça múltiplas requisições desnecessárias - Não solicite mais dados que o necessário (use limit) - Não faça operações pesadas em horários de pico

Usabilidade

✅ SIM: - Sempre confirme operações críticas (cancelar, deletar) - Exiba mensagens claras sobre status das operações - Valide dados do usuário antes de enviar para Shopify - Trate erros com mensagens amigáveis

❌ NÃO: - Não assuma que operações sempre funcionam (trate erros) - Não exiba IDs técnicos para usuários finais - Não force usuário a saber IDs (use SEARCH)

Limites da API Shopify

Limite Valor Descrição
Rate Limit 2 req/s Máximo 2 requisições por segundo
Burst 40 req Burst de até 40 requisições
List Limit 250 Máximo 250 items por listagem
Paginação Sim Use paginação para > 250 items

Como Lidar com Rate Limit

{
  "nodes": [
    {"type": "shopify", "operation": "list"},
    {"type": "delay", "parameters": {"duration": 1, "unit": "seconds"}},
    {"type": "shopify", "operation": "get"}
  ]
}

Troubleshooting

Erro 401 - Unauthorized

  • Causa: AccessToken inválido ou expirado
  • Solução: Gere novo token no Shopify Admin

Erro 404 - Not Found

  • Causa: ID de produto/pedido/cliente não existe
  • Solução: Valide ID antes de operações (use GET/SEARCH)

Erro 422 - Unprocessable Entity

  • Causa: Dados inválidos (email duplicado, campos obrigatórios faltando)
  • Solução: Valide dados antes de enviar

Erro 429 - Too Many Requests

  • Causa: Rate limit excedido
  • Solução: Adicione delays entre requisições

Suporte e Recursos

Documentação Shopify

Tutoriais

  1. Configurar Private App
  2. Gerar Access Token
  3. API Rate Limits

Changelog

v2025-01 (Atual)

  • Suporte completo para Products (5 operações)
  • Suporte completo para Orders (4 operações)
  • Suporte completo para Customers (4 operações)
  • Total: 13 operações documentadas

Contribuições

Encontrou um bug ou tem sugestão de melhoria? Entre em contato com o suporte do Lumina Flow Builder.

Nota: Esta integração utiliza a Shopify Admin REST API versão 2025-01. Certifique-se de que sua loja Shopify está atualizada para melhor compatibilidade.