TOTVS CAROL - Carol Connect (2C) - O que fazer no caso do erro Error API token or connector Id is invalid

Tempo aproximado para leitura: 00:10:00 min

Dúvida
Carol Connect (2C) - O que fazer no caso do erro Error API token or connector Id is invalid?

Ambiente
TOTVS CAROL - Carol Connect (2C) - Todas as versões.

Solução
O primeiro passo é identificar a mensagem de erro completa, caso tenha dificuldades acesse nosso artigo: TOTVS CAROL - Carol Connect (2C) - Como identificar e tratar mensagens de [ERROR] exibidas nos Logs do 2C?

Ao analisar o Log da imagem abaixo, encontramos a seguinte mensagem: "[ERROR] c.t.m.d.e.EntityService - Erro ao tentar desabilitar entidades no banco de dados X". No entanto, ao ler a linha completa do erro, percebemos uma mensagem mais detalhada que diz: "errorMessage='O token da API ou o connectorId está inválido', possível campo responsável='Autorização, ou X-Auth-Key e X-Auth-ConnectorId estão inválidos.". Isso significa que o Token e/ou Connector Id configurados no 2C estão inválidos.





Para solucionar o erro é necessário a atuação do responsável pela configuração do Carol Connect (2C), será necessário acessá-lo e verificar os dois itens do erro informado.

No caso do Token inválido, você deve acessar o seu 2C - Carol Connect e selecionar a opção Edit Connection. Caso não esteja conseguindo acessar o seu 2C, o erro pode ter corrompido seu arquivo de configuração, então será necessário refazer toda a configuração do 2C:

TOTVS CAROL - Carol Connect (2C) - Como criar uma conexão limpa do 2C no Windows.



Dentro dessa opção valide as informações do Ambiente/Tenant e clique sobre Reset Connector Token.



Depois, você pode clicar em Generate Connector Token para criar um novo Token com o usuário que fez o Login no 2C, ou pode inserir manualmente um Token gerado pela Plataforma Carol.

Observação: Ressaltamos a importância de  utilizar um usuário exclusivo para o 2C para evitar duplicação de tokens, gerando a revogação do mesmo.
Em caso de dúvida sobre a geração do Token, acesse nosso artigo: TOTVS CAROL - Carol Plataforma - Para que servem e como criar Connector Token (API Key) manualmente? 



No caso do Connector ID inválido, será necessário deletar a conexão dentro do 2C - Carol Connect e criar uma nova. Em caso de dúvidas na criação, avalie nosso artigo ou vídeos sobre o tema.

Para deletar a conexão basta acessar o 2C e deletar através da opção exibida na imagem abaixo. Caso não esteja conseguindo acessar o seu 2C, o erro pode ter corrompido seu arquivo de configuração, então será necessário refazer toda a configuração do 2C, clique aqui para mais detalhes.



O Connector ID pode ficar inválido devido a ações dentro da Plataforma Carol, por exemplo, existem situações de saneamento (exclusão de dados), entre outras, em que acabam deletando o Connector através da Plataforma Carol e reinstalam o APP para recriá-lo da forma correta/original, porém, apesar de ter o mesmo nome, o seu ID interno mudou, ficando diferente do previamente configurado no 2C.



Quando os erros mencionados ocorre, os dados não são enviados para a Plataforma Carol e o 2C continua tentando sem sucesso, o que pode sobrecarregar a CPU e a memória da aplicação. Isso pode resultar em uma performance mais lenta ou até mesmo corromper o arquivo de configuração.

Saiba Mais
CLIQUE AQUI para acessar mais artigos e FAQs do suporte relacionados a TOTVS Carol
CLIQUE AQUI para acessar a documentação técnica da TOTVS Carol no TDN
Carol Connect (2C) - Manual do Usuário
Carol Connect (2C) - Dúvidas Frequentes