Shopify com um app personalizado

A forma habitual de conectar o Shopify é o app do FlowHunt na Shopify App Store (veja lojas de ecommerce). Se você não quer um app público na sua loja, ou se a política da loja bloqueia instalações pela App Store, pode conectar com um app personalizado que você mesmo cria no Shopify Dev Dashboard.

Depois de conectado, um app personalizado funciona igual a uma instalação pela App Store: o orçamento da importação, a importação retroativa de pedidos e produtos, os relatórios de Eshop, a construção de links e o CMS.

As integrações de ecommerce estão disponíveis a partir do plano Pro, e somente administradores do workspace podem conectá-las.

Antes de começar#

• Use a organização Shopify da própria loja. O app precisa pertencer à mesma organização Shopify da loja. Uma agência não pode usar o próprio app na loja de um cliente; é o cliente quem precisa criar o app.
• Cobrança no cartão. Workspaces cobrados pelo Shopify não podem usar um app personalizado. Mude o plano para cobrança no cartão primeiro.
• Permissões no Shopify. Você precisa poder criar apps no Dev Dashboard da loja (o proprietário da loja ou uma conta de equipe com permissão para desenvolver apps).

Crie o app no Shopify#

1. Abra o desenvolvimento de apps no painel do Shopify

   No painel de administração do Shopify, clique em Settings, depois em Apps, depois em Develop apps e clique em Build apps in Dev Dashboard. Você também pode ir direto ao Shopify Dev Dashboard e fazer login com a conta proprietária da loja.

   

   

   

   

2. Crie o app

   No Dev Dashboard, abra Apps e clique em Create app. Se a sua organização já tem apps, clique em Create app no canto superior direito e escolha Create app manually.

   

   

3. Preencha o app e seus escopos

   • App name (1): qualquer nome que você reconheça, por exemplo “AmICited”.
   • App URL (2): https://app.flowhunt.io/. Desmarque Embed app in Shopify admin; o app não tem tela própria dentro do Shopify.
   • Allowed redirection URL(s): deixe em branco. O AmICited faz login com o Client ID e o Client secret do app, então o Shopify nunca redireciona de volta para ele. Deixe Use legacy install flow desmarcado.
   • Scopes (3, em API access): cole esta lista. São os escopos que o app da App Store solicita, então o app personalizado tem acesso a todos os recursos do AmICited, exceto o histórico de pedidos com mais de 60 dias (veja abaixo):

   textCopiar

   read_orders,write_orders,read_products,write_products,read_customers,write_customers,read_inventory,write_inventory,read_locations,write_price_rules,read_content,write_content,read_themes,write_themes,read_locales

   Deixe Webhooks API version como está.

   

   Prefere marcar caixas em vez de colar? Clique em Select from list acima do campo Scopes, procure cada escopo da lista acima (1), marque-o e clique em Done (2).

   

   

4. Crie o app

   Com o nome, a URL e os escopos preenchidos, clique em Create app no canto superior direito do formulário (4 na captura de tela do formulário acima). O Shopify cria o app e lança a primeira versão.

   

5. Confira se a versão está ativa

   Abra Versions no menu do app: a primeira versão aparece marcada como Active. Se você mudar os escopos depois, clique em Create version para que a alteração entre em vigor.

   

6. Defina a distribuição como personalizada

   Um app personalizado precisa ficar restrito à sua própria loja antes de poder ser instalado nela.

   1. No Overview do app, clique no cartão Distribution (Manage custom install link). O Shopify abre o Partners Dashboard; se ele pedir, escolha a conta que você usa para a loja.
   2. Selecione Custom distribution (1) e clique em Select (2). O Shopify não deixa você mudar o método de distribuição depois.
   3. Em Store domain, informe o endereço your-store.myshopify.com da sua loja (1; veja Encontre o endereço da sua loja abaixo) e clique em Generate link (2). A opção Allow multi-store install for one Plus organization só importa se a sua loja fizer parte de uma organização Shopify Plus com várias lojas.

   

   

   

   

7. Instale o app na sua loja

   O app não consegue ler nada enquanto não estiver instalado na loja.

   1. Abra o Overview do app no Dev Dashboard e clique em Install app no topo do cartão Installs. Em alguns painéis esse botão aparece como Test app, como na captura de tela abaixo. Você também pode abrir o menu ⋯ na linha do app na lista Apps e escolher Install app.
   2. Escolha a loja que você quer conectar.
   3. Revise o acesso que o app solicita e clique em Install.

   

   

   

   A tela avisa que “This app hasn’t been reviewed”. Isso é esperado: é o seu próprio app, não um app da App Store.

8. Copie o Client ID e o Client secret

   Abra as Settings do app no Dev Dashboard. Em Credentials, copie o Client ID e o Client secret (use os botões de copiar ao lado de cada campo). Trate o secret como uma senha.

   

   

   

Conecte no AmICited#

1. Encontre o endereço da sua loja

   No painel de administração do Shopify, abra Settings. O endereço da loja (your-store.myshopify.com) aparece abaixo do nome da loja, no topo do menu.

   

2. Abra a caixa de diálogo do Shopify

   Vá a Fontes de dados, em Eshops clique em Connect Shopify Store e depois em Use a custom app instead (1 na captura de tela abaixo).

3. Informe a loja e as credenciais

   Informe o Store address, o Client ID e o Client secret (2) e clique em Connect store (3).

   

4. Escolha o domínio e confirme a importação

   Associe a loja a um domínio e escolha quanto histórico de pedidos importar, como em uma instalação pela App Store. Cada opção mostra a contagem projetada de linhas e o custo único antes de você confirmar.

Depois disso, configure os dados de clientes e as configurações da loja da mesma forma que para qualquer loja.

Como um app personalizado é diferente#

Relacionados#