Reconectar uma integração e resolver falhas de sincronização

Objetivo: recuperar uma integração que pede nova autorização, revisão de credenciais ou deixou de executar sua função. Resultado esperado: o cartão volta ao estado adequado e o teste específico do serviço termina sem erro de autenticação, sem apagar configurações por tentativa.

1. Identifique o estado antes de agir

Abra o cartão da integração e leia a situação exibida. Se estiver Sincronizando, aguarde a conclusão; repetir a ação pode atrasar a conferência. Se aparecer Reconectar, Autorização expirada ou mensagem equivalente, uma integração por autorização externa pode precisar aprovar novamente o acesso. Estados como Atenção, Revisar ou Falta usuário podem indicar configuração incompleta. Se o cartão estiver Conectado, a causa pode estar no teste operacional, e não necessariamente na autorização.

1. Use a busca para localizar o canal correto.
2. Confirme a identificação da loja ou conta mostrada no cartão.
3. Anote a situação, a última atualização visível e a mensagem apresentada.
4. Verifique se a equipe não está trocando a conta que já atende aos pedidos em andamento.

2. Use o método de conexão mostrado no cartão

1. Abra o guia específico da integração e identifique se ela usa autorização externa, credenciais no cartão ou configuração operacional.
2. Autorização externa: clique em Conectar ou Reconectar, conclua o acesso na página oficial do provedor e retorne ao C Controle. Se a janela não abrir, permita pop-ups e tente novamente uma única vez.
3. Chave ou credenciais: revise e salve somente os campos apresentados no cartão. Não envie esses valores ao suporte nem altere campos por tentativa.
4. Configuração do serviço: complete o dado solicitado, como usuário do CChat, credenciais de frete e prazo ou configuração autorizada do recebedor.
5. Aguarde a atualização da situação e execute o teste correspondente: pedidos, cotação, pagamento, usuário ou outra função descrita no guia do cartão.

Quando o cartão oferecer Reconectar, essa ação pode renovar a autorização sem remover a configuração existente. Nos demais conectores, siga o método exibido e o guia específico. Use Desconectar somente em troca planejada de conta, encerramento do serviço ou orientação confirmada do suporte.

3. Separe falha de conexão de falha no pedido

Se a sincronização termina sem alerta de autenticação, mas um pedido não pode ser convertido, a conexão provavelmente está válida. Abra o pedido e confira os avisos. Produto sem vínculo, CPF ou CNPJ indisponível, condição de pagamento, configuração fiscal, valores divergentes, estoque insuficiente ou pedido cancelado devem ser tratados no registro correspondente.

Também confira o período da busca e os filtros de canal e situação. Alguns provedores disponibilizam dados por etapas ou limitam informações do comprador até uma mudança no pedido. Nesses casos, mantenha o registro pendente, sincronize novamente no momento adequado e não invente dados para concluir a venda.

Problemas frequentes

• Autorização volta para a tela inicial: confirme que o navegador aceitou cookies e pop-ups e que a mesma sessão foi usada até o fim.
• Conta errada foi autorizada: pare a validação, não converta novos pedidos e alinhe a troca com o responsável e o suporte.
• Botão continua desabilitado: aguarde a sincronização atual terminar e atualize a página antes de iniciar outra.
• Sincronização não traz pedidos: confira período, filtros, situação no provedor e se o pedido pertence à conta vinculada.
• O erro é apenas em um pedido: abra os detalhes e trate a pendência de produto, cliente, pagamento, fiscal, estoque ou valores.

Como confirmar

O cartão deve indicar o estado esperado para o método utilizado. Em seguida, o teste específico deve concluir sem alerta de autorização ou configuração: um pedido atualizado, uma cotação retornada, um pagamento controlado, um usuário sincronizado ou outro resultado descrito no guia da integração. Confirme também que a conta, o serviço e a empresa são os esperados antes de retomar a operação.

Próximo passo

Valide um pedido do início ao fim. Se a falha continuar, envie ao suporte o canal, o horário da tentativa, a situação do cartão, a mensagem visível e o que deveria ter acontecido, sem incluir credenciais ou dados pessoais desnecessários.

Revisado em: 22/07/2026.