Conectar, gerenciar e reconectar um aplicativo

Entenda os estados de conexão do aplicativo Runner e repare ou remova uma conexão com segurança.

Use este guia para levar um aplicativo através de seu ciclo de vida de conexão: inicie a conexão, confirme seu estado real, repare a autorização quando necessário e desconecte-o com segurança.

Caminho de entrada: Projeto → Aplicativos

Antes de começar

Use quando:

um aplicativo diz Conectar, Conectando..., Reconectar ou Análise pendente;
você precisa verificar se um fluxo de provedor anterior realmente terminou;
um aplicativo de agente precisa de acesso diferente à ferramenta; ou
você pretende remover uma conexão e precisa entender o aviso primeiro.

Você precisa de acesso ao projeto e qualquer conta, credenciais ou aprovação solicitada pelo provedor externo. Alguns aplicativos são condicionais e podem não aparecer em todos os espaços de trabalho.

Leia o cartão antes de agir

Estado ou controle do cartão	Significado	O que fazer
Indicador de carregamento	O Runner está verificando a conexão salva.	Aguarde antes de selecionar outra ação.
Conectar	O Runner não tem uma conexão utilizável para este aplicativo.	Abra o diálogo de configuração ou fluxo de autorização do provedor.
Conectando...	Uma solicitação de conexão está em andamento.	Conclua o fluxo do provedor ou aguarde o Runner retornar um resultado.
Conectado	O Runner reconhece uma conexão utilizável.	Use seu controle de gerenciamento ou desconexão se precisar de uma alteração.
Gerenciar	O aplicativo de agente conectado tem ferramentas configuráveis.	Abra os detalhes do aplicativo e revise o acesso à ferramenta.
Reconectar	A autorização está faltando, expirada ou precisa de atenção.	Inicie a autorização novamente. Não assuma que a conexão antiga ainda funciona.
Análise pendente	O Stripe tem a conta mas não a tornou pronta.	Siga o status ou aviso de ação; o rótulo não é um botão de conexão.
Continuar integração	O Stripe ainda precisa de informações.	Continue a configuração existente em vez de criar outra conta.
Excluir ou Desconectar	Uma conexão pode ser removida.	Leia e confirme o impacto específico do provedor.

Conclua o ciclo de vida

Abra Aplicativos e encontre o aplicativo.
Selecione Conectar.
Forneça apenas os campos mostrados no diálogo. Dependendo do aplicativo, isso pode ser um domínio de loja, uma chave de API, uma chave e segredo, credenciais do provedor ou autorização externa.
Conclua a etapa do provedor e retorne aos aplicativos.
Confirme que o cartão agora mostra um crachá conectado ou os controles conectados do provedor. Um diálogo fechado ou janela do provedor não é prova de sucesso.
Se o cartão mostrar Reconectar ou Continuar integração, selecione essa ação e continue a conexão existente.
Para remover o aplicativo, selecione seu controle de desconexão, leia a confirmação e escolha Desconectar ou Confirmar apenas quando o impacto em todo o espaço de trabalho declarado for aceitável.
Reabra os aplicativos e confirme que o cartão retornou ao seu estado desconectado.

Aplicativos de loja e aplicativos de agente diferem

Os aplicativos de loja usam controles específicos do provedor:

Email usa uma opção ativada/desativada.
Stripe pode mostrar integração, análise, ação necessária, painel e controles de desconexão.
Shippo, CJ Dropshipping, 4PX e Shopify solicitam dados de configuração específicos do provedor e mostram uma confirmação de desconexão destrutiva.

Segurança de conexão

Trate chaves e segredos do provedor como senhas.
Leia se uma conexão pertence ao espaço de trabalho ou apenas ao projeto atual.
Uma janela do provedor sendo concluída não garante que o Runner tenha recebido um resultado utilizável.
Não desconecte um provedor de envio, pagamento, email ou cumprimento durante operações ativas da loja sem verificar o aviso e seus pedidos atuais.
Se uma desconexão falhar, o Runner mantém o estado atual. Não assuma que o provedor foi removido.