Apps personalizados

Apps personalizados são desenvolvidos exclusivamente para a loja da Shopify, diferentemente dos apps públicos, que são criados para funcionar com várias lojas. É possível usar apps personalizados para adicionar recursos ao admin da Shopify, acessar dados da loja diretamente com as APIs da Shopify ou levar a loja virtual a outras plataformas por meio da API Storefront.

A criação de um app personalizado é um processo desafiador, que exige conhecimento especializado. Por isso, se você precisar de ajuda nessa tarefa, lembre-se de que é possível contratar um Especialista da Shopify. Saiba mais sobre a contratação deEspecialistas da Shopify.

Se você quiser que uma conta decolaboradorou membro da equipe tenha permissão para criar, editar ou excluir apps personalizados, basta conceder a permissãoDesenvolver apps. Não esqueça que essa conta também precisa ter aspermissões necessáriaspara definir determinados escopos de API.

Habilitar o desenvolvimento de apps personalizados no admin da Shopify

É preciso que você habilite o desenvolvimento de apps personalizados para a loja antes de criar um app desse tipo. Vale destacar que a permissãoHabilitar o desenvolvimento de appssó pode ser concedida pelo titular da loja.

Etapas:

1. No admin da Shopify, clique emConfigurações>Apps e canais de vendas.

2. Clique emDesenvolver apps.

3. Clique emPermitir desenvolvimento de apps personalizados.

4. Leia o aviso e as informações mostradas e clique emPermitir o desenvolvimento de apps personalizados.

Criar e instalar um app personalizado

Depois dehabilitar o desenvolvimentoe, e possivel criar instalar personalizado嗯应用no admin da Shopify. Lembre-se de que é preciso definir os escopos da API para determinar a quais partes da loja o app personalizado terá acesso. Após a instalação, você receberá os tokens usados pelo app para acessar as informações da loja por meio das APIs da Shopify.

Se tiverem aspermissões necessárias, o titular da loja, os colaboradores e os membros da equipe poderão criar e instalar apps personalizados.

Criar o app

1. No admin da Shopify, clique emConfigurações>Apps e canais de vendas.

2. Clique emDesenvolver apps.

3. Clique emCriar um app personalizado.

4. Na janela modal, digite oNome do appe selecione umDesenvolvedor do app. Este último pode ser o titular da loja, uma conta de colaborador ou um membro da equipe que tenha a permissãoDesenvolver apps.

5. Clique emCriar app.

Selecionar escopos da API

Após a criação, é possível atribuir escopos da API Admin, da API Storefront ou de ambas, de acordo com os requisitos do app personalizado.

1. Clique emSelecionar escopos.

2. Na seçãoEscopos de acesso da API Admin, escolha os escopos de API que serão atribuídos ao app.

3. Na seçãoEscopos de acesso da API Storefront, escolha os escopos de API que você quer atribuir ao app.

4. Clique emSalvar.

Instalar o app e receber os tokens de acesso à API

Após definir os escopos da API, instale o app. Somente depois disso você terá os tokens de acesso à API, que variam de acordo com os escopos atribuídos. Portanto, você pode receber um token de acesso da API Admin, da API Storefront ou de ambas.

1. Clique emInstalar app.
2. Na janela modal, clique emInstalar app.
3. Receba o token de acesso:

• Se você selecionou os escopos da API Admin para o app, acesse a seçãoToken de acesso da API Admine clique emRevelar token uma vez.

• Se você selecionou os escopos da API Storefront para o app, acesse a seçãoToken de acesso da API Storefronte copie as informações. Ao contrário do token de acesso da API Admin, esse token está sempre disponível nesta página.

Depois de revelar o token de acesso completo uma vez, a página mostrará só os últimos quatro dígitos, para fins de consulta.

Localizar as credenciais da API de um app personalizado

É possível conferir o token de acesso da API Storefront, a chave de API e o segredo da API de um app personalizado na página decredenciais da API. Lembre-se de que outra opção é consultar o token de acesso da API Admin, mas, após vê-lo uma vez, você só poderá verificar os quatro últimos dígitos.

1. No admin da Shopify, clique emConfigurações>Apps e canais de vendas.

2. Clique emDesenvolver apps.

3. Clique no nome do app cujas credenciais você quer localizar.

4. Clique emCredenciais da API.

Atualizar escopos da API Admin de um app personalizado

Se você é titular da loja, colaborador ou membro da equipe com aspermissões necessárias,颇得atualizar os escopos de personalizad嗯应用o.

1. No admin da Shopify, clique emConfigurações>Apps e canais de vendas.

2. Clique emDesenvolver apps.

3. Clique no nome do app que você quer atualizar.

4. Clique emConfiguração.

5. Na seçãoIntegração da API Admin, clique emEditar.

Caso você ainda não tenha atribuído escopos à API Admin, clique emConfigurar.

1. Selecione os escopos que você quer atribuir ao app.
2. Opcional: defina a versão da API que você quer usar para assinaturas de webhook.
3. Opcional: é possível configurar o Google Cloud Pub/Sub para lidar com as assinaturas de webhook do app. Para fazer isso, na seçãoGoogle Cloud Pub/Sub, copie oendereço da conta de serviço da Shopifye use essa informação para configurar a conta do Google Cloud Pub/Sub.

4. Opcional: é possível configurar o Amazon EventBridge para lidar com as assinaturas de webhook do app. Para fazer isso, na seçãoAmazon EventBridge, clique emCriar origem.

5. Clique emSalvar.

Se o应用ja estiver instalado na loja,低地nao terá a opçãoSalvar, a menos que um escopo esteja selecionado ou caso o app tenha os escopos da API Storefront atribuídos.

Atualizar os escopos de acesso da API Storefront de um app personalizado

Se você é titular da loja, colaborador ou membro da equipe com aspermissões necessárias,颇得atualizar os escopos de personalizad嗯应用o.

1. No admin da Shopify, clique emConfigurações>Apps e canais de vendas.

2. Clique emDesenvolver apps.

3. Clique no nome do app que você quer atualizar.

4. Clique emConfiguração.

5. Na seçãoIntegração da API Storefront, clique emEditar.

Caso você ainda não tenha atribuído escopos à API Storefront, clique emConfigurar.

1. Selecione os escopos que você quer atribuir ao app.
2. Opcional: caso o app tenha integração com oSDK Buy para iOS, faça as alterações necessárias na seção correspondente. Vale lembrar que só será possível modificar essa seção se o app já tiver sido instalado.

Consulte adocumentação para desenvolvedores do SDK Buy para iOSe veja instruções mais detalhadas. Atenção: a página em questão está disponível apenas em inglês.

1. Opcional: caso o app tenha integração com oSDK Buy para Android, faça as alterações necessárias na seção correspondente. Vale lembrar que só será possível modificar essa seção se o app já tiver sido instalado.

Consulte adocumentação para desenvolvedores do SDK Buy para Androide veja instruções mais detalhadas. Atenção: a página em questão está disponível apenas em inglês.

1. Clique emSalvar.

Se o应用ja estiver instalado na loja,低地nao terá a opçãoSalvar, a menos que um escopo esteja selecionado ou caso o app tenha os escopos da API Storefront atribuídos.

Atualizar configurações de um app personalizado

É possível atualizar o nome, a descrição e o desenvolvedor do app.

Se você definir o desenvolvedor do app como uma conta de membro da equipe ou colaborador e excluí-la posteriormente, o titular da loja se tornará o desenvolvedor do app por padrão.

1. No admin da Shopify, clique emConfigurações>Apps e canais de vendas.

2. Clique emDesenvolver apps.

3. Clique no nome do app que você quer atualizar.

4. Clique emConfigurações do app.

5. Para alterar o nome ou a descrição, insira um novoNome do appou umaDescrição do app.

6. Para alterar o desenvolvedor associado ao app, selecione oDesenvolvedor principal do app.

7. Opcional: para notificar outro e-mail sobre atualizações de desenvolvimento do app, insira o endereço emContato para atualização de desenvolvimento.

8. Clique emSalvar.

Desinstalar um app personalizado

Quando você desinstala um app personalizado, os tokens de acesso das APIs Admin e Storefront são revogados e não podem mais acessar os dados da loja. Portanto, se você instalar o app de novo, terá novos tokens de acesso.

1. No admin da Shopify, clique emConfigurações>Apps e canais de vendas.

2. Clique emDesenvolver apps.

3. Clique no nome do app que você quer desinstalar.

4. Clique emDesinstalar app.

Excluir um app personalizado

Quando você exclui um app personalizado, não é possível recuperá-lo. Se você quiser desabilitar temporariamente um app na loja sem excluí-lo,desinstale o app.

1. No admin da Shopify, clique emConfigurações>Apps e canais de vendas.

2. Clique emDesenvolver apps.

3. Clique emConfigurações do app.

4. Clique emExcluir app.

Permissões de escopo da API para apps personalizados

Contas de colaborador e membro da equipe só poderão definir escopos da API para apps personalizados se tiverem a permissãoDesenvolver apps, bem como outraspermissões de equiperelacionadas aos escopos da API definidos.

Consulte o desenvolvedor do app para saber quais permissões de conta e escopos da API são necessários para o funcionamento do app personalizado. Vale lembrar que o ideal é que você entenda e se sinta confortável com as permissões concedidas ao desenvolvedor.