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.