---
title: Conectar, gerenciar e reconectar um aplicativo
description: 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

1. Abra **Aplicativos** e encontre o aplicativo.
2. Selecione **Conectar**.
3. 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.
4. Conclua a etapa do provedor e retorne aos aplicativos.
5. 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.
6. Se o cartão mostrar **Reconectar** ou **Continuar integração**, selecione essa ação e
   continue a conexão existente.
7. 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.
8. 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.

## Guias relacionados

- [Visão geral de aplicativos e integrações](../apps-and-integrations)
- [Conectar e controlar aplicativos de agente](./agent-apps)
- [Solucionar problemas de conexão de um aplicativo](./troubleshooting)