VolundOS

Credencial própria para conectar um serviço

Alguns serviços exigem que a organização registre a própria aplicação antes de qualquer pessoa conectar — configuração feita uma vez, isolada por organização.

Atualizado em 02 de setembro de 2026

Credencial própria para conectar um serviço

Camada funcional

Alguns serviços não permitem conexão com credencial compartilhada: exigem que a organização registre a própria aplicação (identificador e segredo de cliente) junto ao serviço, antes de qualquer pessoa conectar. Essa configuração é feita uma vez e serve a todos daquela organização.

Por que isso existe: isolar organizações diferentes

A ferramenta de integrações usada por baixo dos panos guarda essas configurações num espaço compartilhado entre organizações, sem uma fronteira própria entre elas do lado do serviço. Por isso a plataforma mantém, do seu próprio lado, um registro de qual organização é dona de cada configuração — garantindo que uma organização só alcança as configurações que ela mesma criou, mesmo que um identificador vaze ou seja adivinhado. É um padrão que se repete: quando um serviço externo não oferece a fronteira entre organizações que a plataforma precisa, essa fronteira é construída do lado de dentro.

Quando o formulário de credencial aparece

O formulário de credencial própria não é fixo: ele aparece apenas para os serviços que exigem essa configuração antes de conectar. Para os demais, a conexão segue o caminho padrão, sem pedir nada extra.

Quando o serviço aceita os dois caminhos, quem escolhe é você (01/09/2026)

A maioria dos serviços do catálogo só oferece um jeito de conectar: ou você entra na conta pelo próprio serviço, ou informa uma chave de acesso. Mas algumas dezenas aceitam os dois — e entre elas estão justamente as mais usadas no dia a dia.

Para esses, a plataforma passou a perguntar, em vez de decidir por você. A pergunta aparece nos três lugares em que uma conexão começa: no catálogo de Integrações, ao escolher um serviço na configuração do agente e ao reconectar uma conta que caiu.

"Entrar com o serviço" vem primeiro e recomendada, por duas razões concretas: você não digita nem guarda segredo nenhum, e pode cancelar o acesso do lado do serviço quando quiser, sem depender da plataforma. A chave de acesso continua ali para quem já tem uma em mãos, ou para quem trabalha numa conta que não permite autorizar aplicativos de fora.

Para os serviços que aceitam um caminho só, nada mudou: o único possível abre direto, sem pergunta no meio.

Uma configuração antiga deixou de decidir por você. Se a organização já tivesse registrado uma credencial própria de chave para um desses serviços, a plataforma seguia por esse caminho sozinha — para todo mundo, e mesmo quando aquele registro era só resíduo de uma tentativa abandonada. A pergunta acima só passou a valer depois que isso foi corrigido.

O que dá para fazer

  • Ver, criar, ler e remover uma configuração de credencial própria.
  • Remover várias configurações de uma vez — útil depois de tentativas de conexão que deixam resíduo.

Não confundir com o cofre

São dois mecanismos diferentes:

Credencial própria de integraçãoCofre
O que guardaa credencial da própria aplicação da organização junto ao serviçocredencial de uso (senha, chave, cartão, código de autenticação)
Quem usao fluxo de autorização da integraçãoo agente, ao preencher um formulário ou uma variável
Escopoa organização inteirao agente, com compartilhamento

On this page