---
title: Solucionar problemas de conexão de aplicativo
description: Diagnostique problemas de carregamento, credenciais, autorização, revisão, reconexão e desconexão em Apps.
---

Use este guia quando um aplicativo não carrega, conecta, reconecta, salva seu acesso à ferramenta ou
desconecta conforme esperado. Comece a partir do estado que o Runner realmente mostra em vez de repetir um
fluxo de provedor cegamente.

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

## Antes de começar

1. Confirme que você abriu Apps para o projeto e espaço de trabalho pretendidos.
2. Limpe **Pesquisar aplicativos** e qualquer filtro de categoria de Agent Apps.
3. Atualize a página uma vez e aguarde o carregamento dos estados de conexão.
4. Leia o estado exato do cartão: **Conectar**, **Conectando...**, **Conectado**, **Reconectar**,
   **Revisão pendente** ou um aviso de ação necessária.
5. Abra apenas a ação de recuperação que corresponde a esse estado.
6. Nunca inclua uma chave de API, segredo, documento de identidade, detalhe de pagamento ou URL de callback completa do provedor em uma mensagem de suporte ou captura de tela.

## Controles e resultados importantes

| Controle | O que acontece depois que você o seleciona |
| --- | --- |
| **Limpar pesquisa** | Remove a pesquisa atual de Agent Apps para que o catálogo disponível possa aparecer novamente. |
| **Conectar** / **Conectar e autorizar** | Abre o fluxo de configuração ou autorização externa para esse aplicativo. |
| **Reconectar**, quando mostrado | Reinicia a autorização para uma conexão de provedor existente. |
| **Tentar novamente** | Repete a solicitação de catálogo, lista de ferramentas ou conexão com falha mostrada pelo painel atual. |
| **Continuar integração** | Retorna ao fluxo de integração Stripe existente quando a ação é necessária. |
| **Desconectar** | Abre uma confirmação ou inicia o fluxo de remoção documentado; verifique o estado salvo antes de alterar credenciais do lado do provedor. |

## Tabela de sintoma e recuperação

| O que você vê | Significado provável | Próxima ação segura |
| --- | --- | --- |
| Aplicativo está faltando | Pesquisa, uma categoria, acesso ao espaço de trabalho ou um recurso condicional está ocultando-o. | Limpe a pesquisa, escolha **Todos**, depois confirme que o recurso está disponível para este espaço de trabalho. |
| Cartão continua carregando | O Runner não resolveu a conexão salva. | Atualize Apps uma vez. Evite enviar outra conexão enquanto o estado é desconhecido. |
| **Nenhum aplicativo encontrado** | Nenhum Agent App corresponde aos filtros atuais. | Selecione **Limpar pesquisa**. |
| **Conectar** não faz nada | Um campo obrigatório está vazio ou inválido, ou o fluxo do provedor não pôde ser iniciado. | Leia erros de campo, copie novamente o valor obrigatório e permita popups do provedor quando aplicável. |
| **Conectando...** não termina | A autorização externa foi fechada, bloqueada ou nunca retornou um resultado. | Retorne a Apps, atualize o estado e use **Reconectar** se o Runner oferecer. |
| Provedor diz sucesso mas Runner não | O Runner não confirmou uma conexão utilizável. | Reabra Apps. Trate apenas **Conectado** como sucesso; use **Reconectar** em vez de criar duplicatas. |
| **Reconectar** | A autorização existente precisa de atenção. | Selecione-a e complete o fluxo do provedor novamente. |
| **Revisão pendente** | Stripe está revisando os detalhes enviados. | Siga avisos de ação; não inicie outra conta apenas para remover o rótulo. |
| **Ações do Stripe necessárias** | Stripe precisa de informações ou pausou uma capacidade. | Revise **Vencido agora**, **Vencido depois**, **Em revisão**, pagamento e avisos de saque, depois use **Continuar integração** quando mostrado. |
| Chave de API ou segredo rejeitado | O valor está errado, expirou, é de uma conta errada ou não é aceito para esta integração. | Copie-o novamente do provedor. Não edite segredos por adivinhação. |
| Domínio Shopify inválido | O valor não é o domínio permanente da loja Shopify. | Use `your-store.myshopify.com`, não um domínio de loja personalizado. |
| Janela de autorização do Agent App está bloqueada | O navegador impediu o fluxo externo. | Permita popups para Runner e inicie **Conectar e autorizar** novamente. |
| Ferramentas do Agent App falham ao carregar | O Runner não pôde recuperar a lista de ferramentas desse aplicativo. | Selecione **Tentar novamente** em **Detalhes do aplicativo**. |
| Comutador de ferramenta relata falha | A nova configuração de ferramenta não foi salva. | Aguarde o comutador atualizar, confirme seu estado atual e tente novamente uma vez. |
| Desconexão relata falha | O Runner não confirmou a remoção. | Suponha que a conexão existente ainda está ativa e reabra Apps antes de tentar novamente. |

## Verificações específicas do provedor

### Stripe

- Continue uma tentativa de integração existente com **Reconectar** ou **Continuar integração**.
- Leia os requisitos de ação em vez de confiar apenas na cor do cartão.
- Uma loja publicada ainda pode ter pagamentos pausados ou indisponíveis.
- Use a ação do painel Stripe apenas depois que o Runner tiver uma conta associada.

### E-mail

- Uma mudança de comutador com falha retorna ao estado salvo.
- Um comutador ativado não prova que um email específico foi entregue.
- Verifique o evento da loja, destinatário, configuração de email e versão publicada atualmente
  com dados de teste seguros.

### Shippo

- Copie novamente a chave de API do Shippo da conta pretendida.
- Um cartão conectado não verifica taxas, transportadoras, rótulos ou criação de remessa.

### Shopify

- Use o domínio permanente `myshopify.com`.
- Se um espaço de trabalho já tiver uma loja conectada, revise-a antes de desconectar.
- Reinicie a autorização quando o link de conexão expirar ou a loja retornada não
  corresponder ao domínio que você inseriu.

### CJ Dropshipping

- Confirme que a chave de API pertence à conta CJ que você pretende usar.
- Após desconectar, o Runner volta para a conta CJ compartilhada, então verifique o contexto da conta
  antes de futuras ações de fornecedor.

### 4PX

- Confirme que a chave de API e o segredo pertencem à mesma conta e estão nos campos corretos.
- Um cartão conectado não prova que um destino ou pedido é elegível para cumprimento.

### Apps de Agent

- A seção inteira ou um aplicativo individual pode estar condicionalmente indisponível.
- Limpe filtros antes de tratar um aplicativo como ausente.
- Revise comutadores de ferramenta antes de reconectar; não conceda mais acesso apenas para facilitar a configuração.

## Desconexão falhou ou produziu um resultado incerto

1. Mantenha a conta do provedor e as operações atuais da loja inalteradas.
2. Reabra **Projeto → Apps** e verifique o estado do cartão.
3. Se ainda mostrar conectado, trate a conexão como ativa.
4. Não exclua credenciais do lado do provedor até entender se o checkout ativo, email,
   envio, fornecedor ou trabalho de cumprimento ainda depende delas.
5. Tente novamente a desconexão do Runner apenas depois que o estado estiver claro.

## Peça ajuda com segurança

Fornecimento:

- o nome do aplicativo;
- o estado visível exato e texto de erro;
- se o problema ocorre ao conectar, retornar, gerenciar ferramentas ou desconectar;
- a URL do projeto sem valores de consulta secretos; e
- uma captura de tela segura para privacidade se mostrar materialmente o problema.

Não forneça a chave de API real, segredo, senha do provedor, documento de identidade, detalhes de pagamento,
dados do cliente ou parâmetros de autorização ocultos.

## Guias relacionados

- [Visão geral de aplicativos e integrações](../apps-and-integrations)
- [Conectar, gerenciar e reconectar um aplicativo](./connect-manage-reconnect)
- [Conectar e controlar Agent Apps](./agent-apps)