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.
As capturas de tela e as gravações mostram a interface em inglês. Os nomes dos controles podem variar conforme o idioma selecionado.
Use este guia para conduzir um aplicativo pelo ciclo de vida da conexão: inicie a conexão, confirme seu estado real, autorize o reparo quando necessário e desconecte-o com segurança.
Caminho de entrada: Projeto → Aplicativos
Antes de começar
Use-o quando:
- um aplicativo diz Conectar, Conectando…, Reconectar ou Em revisão;
- você precisa verificar se um fluxo anterior do provedor realmente terminou;
- um aplicativo de agente precisa de acesso a ferramentas diferentes; ou
- você pretende remover uma conexão e precisa primeiro entender o aviso.
Você precisa de acesso ao projeto e a qualquer conta, credenciais ou aprovação solicitada pelo fornecedor externo. Alguns aplicativos são condicionais e podem não aparecer em todos os espaços de trabalho.
No celular, toque na linha do provedor para abrir a caixa de diálogo de detalhes antes de escolher Conectar. Agent Apps está disponível em Conecte suas ferramentas; os provedores de lojas vivem sob Gerencie sua loja. Para CJ, use o guia de conexão do fornecedor .
As anotações em inglês indicam os controles. Selecione a imagem para ampliá-la.
Identifique o provedor e seu estado atual antes de abrir a configuração. Os controlos ligados existentes não constituem prova de uma nova autorização.
Leia o cartão antes de agir
| Estado ou controle do cartão | Significado | O que fazer |
|---|---|---|
| Indicador de carga | Runner está verificando a conexão salva. | Aguarde antes de selecionar outra ação. |
| Conectar | Runner não possui conexão utilizável para este aplicativo. | Abra a caixa de diálogo de configuração ou o fluxo de autorização do provedor. |
| Conectando… | Uma solicitação de conexão está em andamento. | Conclua o fluxo do provedor ou aguarde Runner retornar um resultado. |
| Conectado | Runner reconhece uma conexão utilizável. | Use seu gerenciamento ou controle de desconexão se precisar de uma mudança. |
| Gerenciar | O Agent App conectado possui ferramentas configuráveis. | Abra os detalhes do aplicativo e revise o acesso à ferramenta. |
| Reconectar | A autorização está faltando, expirou ou precisa de atenção. | Inicie a autorização novamente. Não presuma que a conexão antiga ainda funciona. |
| Em revisão | Stripe possui a conta, mas não a preparou. | Acompanhe o status ou aviso de ação; o rótulo não é um botão Conectar. |
| Continuar integraçã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. |
Conectar ou reparar uma conexão
- Abra Apps e encontre o aplicativo.
- Selecione Conectar.
- Forneça apenas os campos mostrados na caixa de diálogo. Dependendo do aplicativo, pode ser uma loja domínio, uma chave de API, uma chave e um segredo, credenciais de provedor ou autorização externa.
- Conclua a etapa do provedor e retorne para Aplicativos.
- Confirme se o cartão agora mostra um crachá conectado ou os controles conectados do provedor. Uma caixa de diálogo ou janela de provedor fechada não é prova de sucesso.
- Se o cartão mostrar Reconectar ou Continue Onboarding, selecione essa ação e continuar a conexão existente.
Desconecte apenas quando quiser remover o acesso
- Para remover o aplicativo, selecione seu controle de desconexão, leia a confirmação e escolha Desconectar ou Confirmar somente quando o impacto declarado em todo o espaço de trabalho for aceitável.
- Abra novamente os aplicativos e confirme se o cartão voltou ao estado desconectado.
A gravação abre os formulários Shippo, 4PX e Shopify em branco e depois os fecha. Nenhuma credencial é inserida e nenhum provedor está conectado.
Provedores de loja e aplicativos de agente são diferentes
Os provedores sob Gerencie sua loja utilizam controles específicos do provedor:
- E-mail usa um botão liga/desliga.
- Stripe pode mostrar integração, revisão, ação necessária, painel e desconexão controles.
- Shippo, 4PX e Shopify solicitam configuração específica do provedor dados e mostram uma confirmação de desconexão destrutiva.
Segurança de conexão
- Trate as chaves e os segredos do provedor como senhas.
- Leia se uma conexão pertence ao espaço de trabalho ou apenas ao projeto atual.
- A conclusão de uma janela de provedor não garante que Runner tenha recebido um resultado utilizável.
- Não desconecte um provedor de remessa, pagamento, e-mail ou atendimento durante o período ativo armazenar operações sem verificar o aviso e seus pedidos atuais.
- Se uma desconexão reportar um erro, atualize e inspecione o estado atual antes de tentar novamente. Não presuma que o provedor foi removido.