Instalar e configurar apps

Depois de encontrar um app que deseja usar, será necessário adicioná-lo à loja. É possível instalar um app pela Shopify App Store, com um link de instalação de terceiros ou com um link exclusivo fornecido por um desenvolvedor para apps personalizados. Após a instalação, alguns apps também são compatíveis com blocos, que podem ser adicionados às páginas principais do admin da Shopify para acesso rápido aos recursos do app.

Revisar o acesso do app antes da instalação

Antes de instalar um app, a Shopify mostra uma tela Instalar app que exibe os dados e as áreas da loja aos quais o app precisa de acesso. Revise essas informações com cuidado antes de prosseguir.

A tela de instalação mostra duas categorias de acesso:

• Ver dados pessoais: os tipos de dados pessoais que o app pode ver, como clientes, o titular da loja e os colaboradores do blog.
• Ver e editar os dados da loja: as áreas da loja que o app pode ver e editar, como clientes, produtos, pedidos, descontos, cartões-presente, marketing, análise da loja e Loja virtual.

É possível expandir cada categoria para visualizar as permissões específicas que o app está solicitando. A tela de instalação também inclui um link para a Política de privacidade do desenvolvedor do app. Assim, você pode conferir como os dados são manipulados antes de instalá-lo. Saiba mais sobre os tipos de informações de identificação pessoal que os apps podem acessar.

Após instalar um app, é possível revisar as atividades e permissões dele a qualquer momento na página "Sobre" do app.

Instalar um app pela Shopify App Store

Passos:

1. Faça login na Shopify App Store.
2. Pesquise um app que você queira instalar e clique na listagem de app.
3. Na página da listagem de app, clique em Instalar.
4. Na tela Instalar app, analise os requisitos de acesso aos dados e a política de privacidade do app.
5. Para autorizar o uso do app, clique em Instalar.

Após a instalação do app, você pode visualizá-lo e usá-lo na página Apps do admin da Shopify.

Instalar um app com um link de instalação de terceiros

Observação

Os links de instalação de terceiros funcionam apenas em apps criados antes de 5 de dezembro de 2019. Se você clicar em um link desse tipo para um app criado depois dessa data, uma mensagem de erro será exibida no admin da Shopify e não será possível instalá-lo.

Passos:

1. Obtenha o link de instalação do app no site do desenvolvedor e clique nele.
2. Na tela Instalar app, analise os requisitos de acesso aos dados e a política de privacidade do app.
3. Para autorizar o uso do app, clique em Instalar app.

Ao instalar com um link de instalação de terceiros, você recebe um aviso de que o app não é da Shopify App Store. Isso não significa necessariamente que o app não seja seguro. No entanto, o app não passou pelo processo de verificação e aprovação exigido para apps listados na Shopify App Store.

Instalar um app personalizado

Se você contratar um desenvolvedor para criar um app personalizado para a loja na Shopify, ele fornecerá um link de instalação. Os links de instalação de apps personalizados são específicos para a loja e não podem ser usados para instalar o app em outra loja.

Passos:

1. Solicite o link de instalação do app ao desenvolvedor e clique no link.
2. Na tela Instalar app, analise os requisitos de acesso aos dados e a política de privacidade do app.
3. Para autorizar o uso do app, clique em Instalar app.

Por motivos de segurança, os links de instalação personalizados expiram após sete dias. Se o link expirar, o desenvolvedor do app precisará fornecer um novo.

Se um desenvolvedor tiver uma conta de colaborador na loja, ele poderá instalar apps personalizados caso receba a permissão completa Gerenciar e instalar apps e canais e se a permissão Aprovar cobranças de apps for ativada. Saiba mais sobre as permissões da loja.

Criar um app personalizado com o Dev Dashboard

É possível criar apps personalizados pelo Dev Dashboard. Os apps personalizados acessam os dados da loja por meio das APIs da Shopify ou estendem a loja virtual para outras plataformas.

Ao criar um app personalizado, você define quais dados e recursos ele pode acessar por meio dos escopos de API, cria versões para gerenciar as alterações e lança o app para disponibilizá-lo para instalação. Cada versão pode ter escopos e configurações diferentes.

Observação

Para ver instruções detalhadas sobre como criar apps personalizados, configurar escopos de API e gerenciar versões do app, consulte a documentação para desenvolvedores da Shopify: criar apps usando o Dev Dashboard.

Passos:

1. No admin da Shopify, acesse Configurações > Apps.

2. Clique em Desenvolver apps.

3. Clique em Criar apps no Dev Dashboard.

4. No Dev Dashboard, clique em Criar app.

5. Na seção Começar no Dev Dashboard, dê um nome ao app e clique em Criar.

6. Crie uma versão do app:

   1. Na seção URLs, defina a URL do app. Se o app não estiver incorporado ao admin da Shopify, será possível usar a URL padrão https://shopify.dev/apps/default-app-home.
   2. Em Versão da API de webhooks, selecione a versão da API de webhooks.
   3. Na seção Acesso, insira os escopos do app.
   4. Clique em Lançar.
   5. Opcional: insira um nome e uma mensagem para a versão.
   6. Clique em Lançar.

Instalar um app personalizado do Dev Dashboard

Após criar um app personalizado, é possível instalá-lo diretamente pelo Dev Dashboard. Você também pode compartilhar o link de instalação do app quando precisar instalá-lo em outras lojas que façam parte da mesma organização.

Observação

Só é possível instalar um app personalizado em outras lojas da mesma organização. Não é possível compartilhar apps com outros lojistas nem com lojas de outra organização.

Passos:

1. No admin da Shopify, acesse Configurações > Apps.

2. Clique em Desenvolver apps.

3. Clique em Criar apps no Dev Dashboard.

4. Na seção Apps, clique no app personalizado que deseja instalar.

5. Na seção Instalações, clique em Instalar app.

6. Opcional: caso tenha várias lojas, selecione a loja na qual deseja instalar o app.

7. Clique em Instalar.

Obter um token de acesso para solicitações de API

Após instalar o app personalizado, o desenvolvedor do app precisa obter um token de acesso para fazer solicitações de API para a loja. Esse processo exige conhecimento de desenvolvimento e não pode ser concluído diretamente pelo admin da Shopify.

Para fazer solicitações de API, o desenvolvedor precisa usar o fluxo de concessão de credenciais do cliente para gerar um token de acesso. Esse é um processo técnico que envolve o uso do ID do cliente e da chave secreta do cliente do app.

Observação

Não é possível copiar e enviar um token de acesso diretamente pelo admin da Shopify. O desenvolvedor precisa gerar o token de acesso. Se estiver trabalhando com uma agência ou com um desenvolvedor de terceiros, compartilhe esta documentação com eles para configurar o acesso à API do app personalizado.

Adicionar blocos ao admin da Shopify

Os blocos permitem usar recursos importantes dos apps diretamente nas páginas principais do admin da Shopify no desktop. É possível adicionar blocos às páginas Produtos, Pedidos e Clientes.

Se você instalou na loja um app que tem um bloco para a página compatível, essa página exibirá a seção Blocos.

Observação

Nem todos os apps têm blocos. Se não houver nenhum app instalado com um bloco em uma página, a seção de blocos ficará oculta.

Passos:

1. No admin da Shopify, acesse a página à qual deseja adicionar um bloco.
2. Na seção Blocos, clique em + Bloco.
3. Clique no nome do bloco que você deseja adicionar à página como pré-visualização.
4. Use o bloco adicionado. O bloco desaparecerá se você sair da página.
5. Opcional: para que um bloco seja exibido permanentemente na página para toda a equipe da loja, clique no ícone Fixar ao lado dele.

Após instalar um app, é possível gerenciar as configurações do app, revisar as cobranças do app ou obter ajuda do desenvolvedor do app. Se precisar remover um app, saiba como desinstalar apps.