Tudo sobre a integração da base de usuários

1. Sincronização de Usuários
   Se sua empresa usa um sistema para cadastrar usuários e dados (como área, departamento, gestor), é possível sincronizar essas informações com a Qulture. Usuários criados no seu sistema serão automaticamente adicionados à plataforma.

2. Autenticação (SSO)
   Com a autenticação via Single Sign-On (SSO), como ADFS, os usuários fazem login na Qulture através do seu sistema de SSO, sem precisar de senha na plataforma da Qulture.

⚙️API de Usuários - Implementação pelo Cliente

A Qulture oferece uma API para consulta e atualização de colaboradores, permitindo integração com seu sistema, como um software de folha de pagamento. Para isso, solicite sua chave de acesso (API token) e peça a um desenvolvedor da sua equipe para implementar a sincronização. Lembre-se que a implementação é de responsabilidade do cliente.

Para iniciar, envie ao desenvolvedor a lista de campos a serem sincronizados. Para isso, acesse Organização → Colaboradores → Adicionar colaborador → Via planilha, baixe o modelo de importação e defina os campos a serem sincronizados. Nossa recomendação é criar uma planilha com duas colunas: "Campo na FONTE" e "Campo na Qulture" (exemplo: City na FONTE = Location na Qulture).

Token de acesso 

→  Acesse Organização → Integrações e gere um token de API de usuários (não confunda com o token da API da Plataforma, que é diferente).

Este token tem privilégios de administrador geral, por isso, envie-o com segurança para a pessoa responsável pela implementação.

Sincronização Diária (Sync) – Qulture Implementa

A Qulture executa um serviço duas vezes ao dia para sincronizar a base de usuários:

• 03:00 UTC (00:00 Brasília)

• 18:00 UTC (15:00 Brasília)

Esse serviço lê a base externa (FONTE) e cria uma importação automática para clientes com a funcionalidade ativa.

⚙️ Como configurar uma integração nativa?

Acesse Configurações → Integrações de Usuários para configurar. 

Aqui mostraremos como fazer a configuração e quais são Integrações estão disponíveis 

ℹ️ Caso você utilize um sistema que possui API REST, podemos avaliar a possibilidade de implementar.

🛠 Opções de Configuração

1️⃣ Pausar sincronização geral
Para pausar o sync para todos os usuários, vá em Integrações de Usuários e clique em "Desativar".
➡️ Útil durante avaliações de desempenho, quando o sistema FONTE está desatualizado.

2️⃣ Pausar sincronização individual
Você pode pausar o sync para usuários específicos, por exemplo:

• Evitar mudanças de hierarquia durante uma avaliação.

• Usuários na Qulture que não existem no sistema FONTE.

3️⃣ Pausar sincronização de líderes
Se a integração sincroniza hierarquia, você pode pausar essa atualização para todos ativando "Não atualizar líderes" em Integrações de Usuários.

4️⃣ Filtrar usuários na sincronização
A integração pode ter filtros configuráveis. Usuários afetados por eles serão ignorados no sync. Como: 

• Sincronizar apenas e-mails corporativos → Filtro por domínio de e-mail
• Se não quiser sincronizar certos usuários, você pode adicionar essa informação em um campo no sistema FONTE e nós configuramos o filtro internamente para ignorá-los na sincronização.
  →  Para seguir com configuração, acione diretamente o canal especializado → Canal para dúvidas técnicas de Integrações, API e SSO
  
  

🔄 Sync de times (Somente Pingboard)  → Integração de usuários - Pingboard

Filtro de Campos de Usuários

Permite criar filtros por expressão regular para extrair partes específicas de um campo de texto.

Exemplo:
Na FONTE, o campo "location" contém "São Paulo/Brasil". Com o filtro, é possível separá-lo na Qulture assim:

• city: "São Paulo"

• country: "Brasil"

Isso é feito aplicando uma regra que usa a barra "/" como delimitador.

👉 Pontos de Atenção

Nas duas integrações, é importante considerar:

1️⃣ Edição na Qulture

• Se um usuário for criado na Qulture mas não existir na FONTE, ele será inativado na próxima sincronização.

• Alterações em campos sincronizados, como líder, serão revertidas caso não estejam iguais na FONTE.

2️⃣ Como evitar perdas de alterações

• Para manter mudanças, edite os dados tanto na Qulture quanto na FONTE antes do próximo sync.

• No caso da sincronização diária (tipo 2), você pode alterar diretamente na FONTE e clicar em sincronizar (se disponível).

3️⃣ Dados não sincronizados

• Campos não incluídos na sincronização podem ser editados sem problemas.
  Exemplo: um campo customizável como "tamanho de camiseta" pode ser alterado livremente na Qulture.

Apagar campos

Se um campo sincronizado na FONTE for apagado, a integração pode parar de funcionar, mesmo que um novo campo com o mesmo nome seja criado, devido à mudança no identificador.

Inativação

Usuários não cadastrados na base da FONTE serão inativados na Qulture.Rocks. A inativação pode ter impactos, então deve ser feita com cuidado.

Alteração de E-mails

Se precisar alterar o e-mail de colaboradores na FONTE, entre em contato com o chat para garantir o melhor processo. Não temos a funcionalidade de "juntar" usuários, então, se um novo usuário for criado para a mesma pessoa, ela pode ter dados (como feedbacks ou metas) duplicados.​

❓Dúvidas Gerais

A integração através da sincronização diária envia convites para as pessoas que forem cadastradas?

Não. No caso da sincronização diária é necessário enviar manualmente pela plataforma.

Dúvidas? Chama a gente no chat 😊