Solucionar problemas de conexão de aplicativo

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

Confirme que você abriu Apps para o projeto e espaço de trabalho pretendidos.
Limpe Pesquisar aplicativos e qualquer filtro de categoria de Agent Apps.
Atualize a página uma vez e aguarde o carregamento dos estados de conexão.
Leia o estado exato do cartão: Conectar, Conectando…, Conectado, Reconectar, Revisão pendente ou um aviso de ação necessária.
Abra apenas a ação de recuperação que corresponde a esse estado.
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

Mantenha a conta do provedor e as operações atuais da loja inalteradas.
Reabra Projeto → Apps e verifique o estado do cartão.
Se ainda mostrar conectado, trate a conexão como ativa.
Não exclua credenciais do lado do provedor até entender se o checkout ativo, email, envio, fornecedor ou trabalho de cumprimento ainda depende delas.
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.