---
title: Conectar Shopify
description: Autorize uma loja Shopify por domínio e compreenda o comportamento de desconexão do Runner.
---

Conecte Shopify quando sua loja ou fluxo de trabalho do Runner precisar de acesso a uma
loja Shopify existente. O Runner inicia a autorização a partir do domínio `myshopify.com` da loja e
Shopify pede que você instale e autorize o aplicativo Runner.

## Antes de começar

**Caminho de entrada:** **Projeto → Apps → Store Apps → Shopify**

Você também pode escolher **Conectar Shopify** ao criar uma loja a partir do espaço de trabalho. Este
guia se concentra no cartão de conexão em Apps.

Você precisa de:

- disponibilidade de integração Shopify no espaço de trabalho;
- um domínio de loja Shopify no formato `your-store.myshopify.com`;
- permissão para instalar e autorizar o aplicativo Runner nessa loja Shopify; e
- autoridade para conectar a loja ao espaço de trabalho do Runner.

Um espaço de trabalho que já possui uma loja Shopify conectada pode exigir que você a desconecte
antes de conectar outra.

## Controles e resultados do Shopify

| Controle | Por que é útil | O que acontece a seguir |
| --- | --- | --- |
| **Conectar** | Abre a configuração do Shopify. | O Runner solicita o **domínio da loja**. |
| **Domínio da loja** | Identifica a loja Shopify exata. | O Runner aceita o formato `your-store.myshopify.com` e mostra um erro para um domínio inválido. |
| **Continuar para Shopify** | Inicia a autorização do provedor. | O Runner redireciona para Shopify para instalar o aplicativo Runner e autorizar o acesso. |
| **Cancelar** ou fechar | Para antes da autorização. | O Runner fecha a caixa de diálogo e limpa o domínio inserido. |
| **Conectando...** | Mostra que o redirecionamento de autorização está começando. | A ação permanece indisponível enquanto o Runner vai para Shopify. |
| Excluir ou **Desconectar** | Inicia a remoção. | O Runner abre **Desconectar Shopify?**. |
| Confirmação **Desconectar** | Remove a conexão Shopify do Runner. | O Runner remove o token da loja Shopify de todos os projetos do espaço de trabalho. A loja Shopify e seus pedidos não são excluídos. |

## Conectar Shopify

1. Abra **Projeto → Apps** e encontre **Shopify**.
2. Selecione **Conectar**.
3. Digite o domínio `myshopify.com` exato da loja em **Domínio da loja**.
4. Corrija qualquer mensagem de domínio inválido antes de continuar.
5. Selecione **Continuar para Shopify**.
6. No Shopify, verifique o nome da loja e o acesso solicitado antes de autorizar o aplicativo Runner.
7. Retorne ao Runner e confirme que o cartão Shopify mostra seu controle de desconexão conectado.
8. Verifique os dados da loja pretendida e o caminho de checkout antes de fazer alterações em tempo real.

## Desconectar ou alterar lojas

Selecione o controle de desconexão e leia **Desconectar Shopify?**. Confirmar remove
o token da loja Shopify de todos os projetos no espaço de trabalho. Não exclui a
loja Shopify ou pedidos Shopify existentes.

Para conectar uma loja Shopify diferente, desconecte a conexão do espaço de trabalho existente primeiro,
confirme que o cartão não está mais conectado e repita a configuração com o domínio da outra loja.

## Se Shopify não se conectar

- Use o domínio permanente `myshopify.com`, não um domínio de loja personalizado.
- Se o Runner disser que o espaço de trabalho já possui uma loja conectada, revise essa conexão
  antes de removê-la.
- Se Shopify rejeitar a autorização, comece novamente no cartão Shopify.
- Se a loja retornada não corresponder ao domínio que você inseriu, pare e verifique qual
  conta e loja Shopify estão abertas.
- Se o link de conexão expirou, comece novamente em **Conectar** em vez de reutilizar a página
  do provedor antigo.
- Se o Runner relatar que o acesso necessário está faltando, revise as permissões do aplicativo no Shopify.
- Se a desconexão falhar, suponha que a conexão existente ainda está ativa.

## Guias relacionados

- [Conectar, gerenciar e reconectar um aplicativo](./connect-manage-reconnect)
- [Solucionar problemas de conexão de aplicativo](./troubleshooting)
- [Visão geral de aplicativos e integrações](../apps-and-integrations)