Integração API: como reconectar a integração com a Pluga quando a autenticação expira?

Se a integração entre a Conta Azul Pro e um aplicativo via Pluga parou de funcionar e você está vendo uma mensagem de erro de autenticação, isso significa que a conexão entre a Conta Azul e a Pluga expirou ou foi invalidada. 

Este artigo explica por que isso acontece e como reconectar em poucos passos.

 

Por que a autenticação expira?

A Pluga se conecta à Conta Azul Pro usando credenciais de autenticação. Com o tempo, essa conexão pode ser invalidada por diferentes motivos, como alteração de senha, atualização de segurança na conta ou inatividade da automatização. 

Quando isso ocorre, a Pluga não consegue mais enviar dados à Conta Azul Pro e os fluxos param de funcionar.

A forma correta de resolver é criar uma nova automatização na Pluga com uma nova conta da Conta Azul conectada, ignorando as conexões antigas que expiraram.

 

Passo a passo para reconectar

  1. Acesse o painel da Pluga diretamente pelo site pluga.co ou pela Conta Azul Pro em Integrações > Automatizadores.
     
  2. Clique em Criar automatização para iniciar um novo fluxo - não tente editar ou reutilizar a automatização antiga.
     
  3. Configure a origem e o destino da automatização conforme o fluxo que você usava antes (por exemplo: Asaas como origem e Conta Azul como destino).
     
  4. Quando o sistema solicitar a conta da Conta Azul, clique em Conectar nova conta

    Ignore as conexões antigas listadas, elas estão com a autenticação expirada.
     
  5. Informe o e-mail e a senha da sua Conta Azul Pro.
     
  6. Quando solicitado, informe o código de autenticação de dois fatores (2FA) gerado pelo seu aplicativo autenticador (Google Authenticator, Microsoft Authenticator ou Authy). 

    Esse código é o mesmo que você usa para fazer login na Conta Azul Pro.
     
  7. Com a conta conectada, clique em Continuar e configure os filtros e mapeamentos do fluxo conforme necessário.
     
  8. Finalize clicando em Finalizar automatização.
     
  9. Faça um teste controlado com poucos registros para confirmar que o fluxo está funcionando corretamente.

 

Dica!

O código de autenticação de dois fatores (2FA) solicitado pela Pluga é o mesmo que você usa para acessar a Conta Azul Pro. 

Ele muda a cada 30 segundos, copie o código mais recente no momento de colar, nunca use um código que acabou de expirar.

 

Após criar a nova automatização, as automatizações antigas com autenticação expirada podem ser desativadas ou excluídas no painel da Pluga para evitar duplicidade de fluxos. 

Verifique com o suporte da Pluga se há eventos com falha acumulados que precisam ser reenviados após a reconexão.

 

Atenção!

A reconexão cria uma nova automatização, ela não recupera automaticamente eventos ou vendas que falharam durante o período em que a autenticação estava expirada. 

Para recuperar esses registros, acesse o painel da Pluga e reenvie os eventos com falha manualmente.

 

Se a mensagem de erro persistir mesmo após criar a nova automatização e conectar uma nova conta, entre em contato com o suporte da Pluga pelo e-mail suporte@pluga.co - a análise da integração é feita pelo lado deles.

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

Comentários

0 comentário

Por favor, entre para comentar.

Esse artigo está
sendo útil?