Solucionar problemas de conexões de aplicativos

Diagnosticar problemas de carregamento, credenciais, autorização, revisão, reconexão e desconexão em aplicativos.

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 quando um aplicativo não carrega, conecta, reconecta, salva o acesso à ferramenta ou desconecte conforme esperado. Comece pelo estado que Runner realmente mostra, em vez de repetir um provedor flui cegamente.

Caminho de entrada: Projeto → Aplicativos

Antes de começar

Confirme se você abriu o Apps para o projeto e espaço de trabalho pretendido.
Limpe Buscar ferramentas e qualquer filtro de categoria de Aplicativos de Agente.
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, Em revisão, ou um aviso de ação necessária.
Abra apenas a ação de recuperação que corresponda a esse estado.
Nunca inclua uma chave de API, segredo, documento de identidade, detalhes de pagamento ou provedor completo URL de retorno de chamada em uma mensagem de suporte ou captura de tela.

Anotações em inglês: Resultados da pesquisa de noção no catálogo de ferramentas

As anotações em inglês indicam os controles. Selecione a imagem para ampliá-la.

A pesquisa restringe o catálogo de ferramentas. Caso sua ferramenta esteja faltando, limpe a busca e os filtros antes de solicitar um aplicativo; um resultado de pesquisa não é uma conexão autorizada.

Controles e resultados importantes

Controle	O que acontece após você selecioná-lo
Limpar pesquisa	Remove a pesquisa atual de Aplicativos de Agente para que o catálogo disponível possa aparecer novamente.
Conectar / Conectar e autorizar	Abre o fluxo de configuração ou autorização externa desse aplicativo.
Reconectar, quando mostrado	Reinicia a autorização para uma conexão de provedor existente.
Tentar novamente	Repete o catálogo, lista de ferramentas ou solicitação de conexão com falha mostrado pelo painel atual.
Continuar integração	Retorna ao fluxo de integração Stripe existente quando uma ação é necessária.
Desconectar	Abre uma confirmação ou inicia o fluxo de remoção documentada; verifique o estado salvo antes de alterar as credenciais do provedor.

Tabela de sintomas e recuperação

O que você vê	Significado provável	Próxima ação segura
O aplicativo está faltando	Pesquisa, categoria, acesso ao espaço de trabalho ou recurso condicional estão ocultando-o.	Limpe a pesquisa, escolha Todos e confirme se o recurso está disponível para este workspace.
O cartão continua carregando	Runner não resolveu a conexão salva.	Atualize os aplicativos uma vez. Evite enviar outra conexão enquanto o estado for desconhecido.
Nenhum aplicativo encontrado	Nenhum aplicativo de agente 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 os erros de campo, copie novamente o valor necessário e permita pop-ups do provedor quando aplicável.
Conectando… não termina	A autorização externa foi fechada, bloqueada ou nunca retornou resultado.	Volte para Aplicativos, atualize o estado e use Reconectar se Runner oferecer.
Provedor diz sucesso, mas Runner não	Runner não confirmou uma conexão utilizável.	Abra novamente os aplicativos. Trate apenas Conectado como sucesso; use Reconectar em vez de criar duplicatas.
Reconectar	A autorização existente precisa de atenção.	Selecione-o e conclua o fluxo do provedor novamente.
Em revisão	Stripe está revisando os detalhes enviados.	Acompanhar 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 um recurso.	Revise Necessário agora, Necessário depois, Em revisão, pagamento e avisos de pagamento e, em seguida, use Continue Onboarding quando mostrado.
Chave API ou segredo rejeitado	O valor está errado, expirou, é de conta errada ou não foi aceito para esta integração.	Copie-o novamente do provedor. Não edite segredos por meio de suposições.
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.
A janela de autorização do aplicativo agente está bloqueada	O navegador impediu o fluxo externo.	Permita pop-ups para Runner e inicie Conectar e autorizar novamente.
As ferramentas do aplicativo do agente não carregam	Runner não pôde recuperar a lista de ferramentas desse aplicativo.	Selecione Tentar novamente em Detalhes do app.
Troca de ferramenta relata falha	A nova configuração da ferramenta não foi salva.	Aguarde a atualização do switch, confirme seu estado atual e tente novamente uma vez.
Desconectar relata falha	Runner não confirmou a remoção.	Suponha que a conexão existente ainda esteja ativa e reabra os aplicativos antes de tentar novamente.

Verificações específicas do provedor

Stripe

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

E-mail

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

Shippo

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

Shopify

Use o domínio myshopify.com permanente.
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 corresponda ao domínio que você inseriu.

CJ Dropshipping

Confirme se a chave API pertence à conta CJ que você pretende usar.
Após a desconexão, futuros CJ autorizados pelo comerciante pesquisam, importam, finalizam a compra e fornecem as operações são bloqueadas até que você restaure uma conexão válida.
Reconecte a mesma conta CJ e verifique novamente as importações existentes. Se a identidade do fornecedor de um item ou os dados ativos não corresponderem mais, remova-os e importe-os novamente.

4PX

Confirme se a chave e o segredo da API pertencem à mesma conta e estão nos campos corretos.
Um cartão conectado não prova que um destino ou pedido seja elegível para atendimento.

Aplicativos de agente

A seção inteira ou um aplicativo individual pode ficar indisponível condicionalmente.
Limpe os filtros antes de tratar um aplicativo como ausente.
Revise as trocas de ferramentas antes de reconectar; não conceda mais acesso apenas para fazer a configuração mais fácil.

A desconexão falhou ou produziu um resultado incerto

Mantenha a conta do provedor e as operações atuais da loja inalteradas.
Abra novamente Projeto → Aplicativos e verifique o estado do cartão.
Se ainda aparecer conectado, trate a conexão como ativa.
Não exclua as credenciais do provedor até saber se o checkout ativo, e-mail, envio, fornecedor ou trabalho de atendimento ainda dependem deles.
Tente novamente a desconexão do Runner somente depois que o estado for limpo.

Peça ajuda com segurança

Fornecer:

o nome do aplicativo;
o estado visível exato e o texto do erro;
se o problema ocorre durante a conexão, devolução, gerenciamento de ferramentas ou desconexão;
a URL do projeto sem valores de consulta secreta; e
uma captura de tela com proteção de privacidade se mostrar materialmente o problema.

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

Se a ferramenta desejada ainda estiver ausente após limpar a pesquisa e os filtros, use Solicitar um app (ou Solicitar este app no resultado vazio). O formulário solicita suporte para um provedor; não o conecta. Para problemas de conexão CJ, abra Configuração do fornecedor Dropshipping.