Como conectar a Instant Landing Page (ILP) ao Shopify

Mudança importante

Comece 1 de janeiro de 2026A partir de agora, a Shopify não oferecerá mais suporte à criação de aplicativos personalizados para lojistas. Isso significa que o método de conexão anterior (criar um aplicativo personalizado e conceder permissões de dados da loja e da vitrine manualmente) não estará mais disponível. 

Para substituir esse fluxo de trabalho, a Shopify disponibiliza o aplicativo Headless oficial na Shopify App Store; a GemPages utiliza esse aplicativo como a nova forma, oficialmente suportada, de conectar o ILP à Shopify.

Antes de começar

Você precisa ter uma loja Shopify com as permissões de administrador necessárias para instalar aplicativos e gerenciar a loja.

Como conectar o ILP ao Shopify (novo método usando aplicativo Headless)

Siga estes passos precisos para conectar uma Página de Destino Instantânea a uma loja Shopify usando o aplicativo Headless da Shopify.

Passo 1: Instale o aplicativo Headless

1. Vá para a Loja de aplicativos do Shopify.

2. Procure por Sem cabeça (o aplicativo oficial Shopify Headless) e clique InstaleSiga as instruções na tela do Shopify para permitir que o aplicativo seja adicionado à sua loja.

Etapa 2: Criar uma loja virtual

1. Dentro do aplicativo Headless, escolha a opção para Criar vitrine.

2. Dê à loja um nome claro que ajude a identificá-la mais tarde e, em seguida, crie-a.

Etapa 3: Gerenciar a API da Loja Virtual

Encontre a seção rotulada API de vitrine e clique Gerenciar.

Etapa 4: (Opcional) Revisar ou editar as permissões da API da loja virtual

Ao criar uma nova loja virtual usando o aplicativo Headless, o Shopify habilita automaticamente todas as permissões de API necessárias para a conexão ILP.

Você só precisa concluir esta etapa se quiser rever as permissões ou editar -os 

1. Selecionar Editar Para visualizar as configurações atuais da API Storefront.

2. Analise as permissões pré-ativadas pela Shopify. Se necessário, você pode ativar escopos adicionais da API Storefront. Clique em Economize se você fizer alguma alteração.

Etapa 5: Copie o Token de Acesso Público

1. Depois de salvar as permissões da loja virtual, localize o Token de acesso público (também chamado de token de publicação) no aplicativo Headless.

2. Clique exemplar Para colocar o token na sua área de transferência.

Passo 6: Cole o token na Página de Destino Instantânea (GemPages)

1. Abra o projeto Instant Landing Page que você deseja conectar no GemPages.

2. Clique Conecte o Shopify dentro das configurações do projeto ILP.

3. Cole o token que você copiou no campo com a etiqueta Token de acesso público.

4. Clique Conecte o ILP ao Shopify.

Se a conexão for bem-sucedida, o Conecte o Shopify O botão será substituído por um Publicar Ao clicar no botão, o GemPages exibirá uma notificação de sucesso confirmando que o ILP agora está conectado à sua loja Shopify.

Como recuperar seu token e reconectar o ILP ao Shopify

Existem dois cenários comuns em que o Token de Acesso Público pode não funcionar mais ou não estar mais disponível. Siga as orientações abaixo, dependendo do motivo da perda do token.

Cenário A: Token perdido porque a loja virtual foi excluída.

Se a loja que emitiu o token for excluída, o token se tornará inválido. Para recuperá-lo:

1. Abra o Sem cabeça Aplicativo no seu painel de administração do Shopify.
2. Crie um novo Storefront (Siga o Passo 2 acima). Você só precisa criar uma loja virtual se não houver outras lojas virtuais existentes que você possa reutilizar.
3. (Opcional) Revise ou edite as permissões da API da loja virtual (siga o Passo 4).
4. Copie o novo Token de acesso público e cole-o no seu projeto ILP (siga os passos 5 e 6).

Alternativa: Se o seu aplicativo Headless ainda contiver outra loja virtual existente (uma que não foi excluída), você não precisa criar uma nova. Basta copiar o Token de Acesso Público dessa loja virtual e colá-lo no ILP.

Cenário B: Token perdido porque o aplicativo Headless foi desinstalado.

Se o aplicativo Headless foi desinstalado da loja, todos os tokens emitidos por meio dele não estarão mais disponíveis. Para recuperar:

1. Reinstale o Sem cabeça aplicativo da App Store da Shopify.
2. Após reinstalar, abra o aplicativo Headless e criar uma vitrine (Etapa 2) ou utilize uma loja já existente, caso ainda haja alguma.
3. Ative todas as permissões da API da loja virtual para essa loja (Etapa 4).
4. Copie o Token de Acesso Público e cole-o no ILP (Etapa 6).