Como Integrar o 4Geeks Perks com seu Software de RH Existente

🤖 Explicar com IA

Gerenciar os benefícios dos funcionários manualmente em diferentes planilhas e sistemas consome muito tempo e é propenso a erros. Ao integrar o 4Geeks Perks com seu Sistema de Informação de Recursos Humanos (HRIS) ou software de folha de pagamento existente, você pode automatizar a gestão de usuários, garantir a elegibilidade precisa dos benefícios e agilizar o processo de integração (onboarding).

Este artigo orienta você na conexão do seu software de RH ao 4Geeks Perks, permitindo uma sincronização de dados perfeita e reduzindo a carga administrativa.

Pré-requisitos¶

Antes de iniciar o processo de integração, certifique-se de atender aos seguintes requisitos:

• Plano Premium Ativo: A integração com sistemas de RH está disponível no plano Premium. Certifique-se de que sua conta tenha passado pelo upgrade.
• Acesso Administrativo: Você deve ter privilégios de Administrador tanto no 4Geeks Console quanto no seu HRIS de destino (ex: Microsoft Entra ID, Workday, BambooHR).
• Credenciais de API: Se estiver usando uma integração personalizada, você precisará de suas Chaves de API exclusivas (Test e Live) na seção Settings > API Keys do console.

Métodos de Integração¶

Existem duas formas principais de integrar seus sistemas de RH com o 4Geeks Perks:

1. SSO Nativo e Sincronização de Diretório: Melhor para organizações que usam grandes provedores de identidade como o Microsoft Entra ID (antigo Azure AD) para gerenciar o acesso e a identidade dos funcionários.
2. Integração Personalizada via API: Ideal para sistemas de RH sob medida ou quando você precisa de uma lógica de sincronização específica e complexa usando a API Personalizada 4Geeks.

Método 1: Conectando via Microsoft Entra ID (SSO)¶

Conectar seu provedor de identidade é a maneira mais rápida de sincronizar sua força de trabalho.

Passo 1: Acessar Configurações de Integração¶

1. Faça login no 4Geeks Console.
2. Navegue até o módulo Perks.
3. Clique em Settings na barra lateral e selecione Integrations.

Passo 2: Autorizar a Conexão¶

1. Localize o Microsoft Entra ID (ou seu provedor específico) na lista de integrações disponíveis.
2. Clique em Connect. Você será redirecionado para a página de login da Microsoft.
3. Entre com as credenciais de Administrador de sua organização e conceda ao 4Geeks Perks permissão para ler os dados do diretório (usuários e grupos).

Passo 3: Configurar Regras de Sincronização¶

Uma vez conectado, configure como os dados fluem entre os sistemas: * User Provisioning: Habilite “Auto-Create Users” para gerar automaticamente uma carteira 4Geeks Perks para novos funcionários adicionados ao seu sistema de RH. * De-provisioning: Habilite “Auto-Archive Users” para revogar instantaneamente o acesso aos benefícios quando um funcionário sair da empresa, protegendo seu orçamento.

Método 2: Usando a API Personalizada¶

Para fluxos de trabalho exclusivos, você pode usar a API 4Geeks para gerenciar programaticamente os funcionários e seus benefícios.

Passo 1: Gerar Chaves de API¶

1. Vá em 4Geeks Console > Settings > API Keys.
2. Copie sua Live Key (começa com sk_live_). Aviso: Nunca compartilhe esta chave publicamente.

Passo 2: Implementar a Sincronização de Usuários¶

Use sua equipe de desenvolvimento ou o 4Geeks Teams para criar um conector que chame a API 4Geeks. Você interagirá principalmente com os endpoints de Usuários (Users) para criar, atualizar ou desativar funcionários com base em gatilhos do seu software de RH.

• Endpoint: POST /v1/users/
• Exemplo de Payload:

  {
    "email": "funcionario@empresa.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "role": "employee",
    "status": "active"
  }
  

Passo 3: Testar a Integração¶

Use sua Test Key (sk_test_) para simular a integração de funcionários sem afetar os dados reais. Certifique-se de que criar um usuário no sandbox do seu RH dispare corretamente a criação de um usuário no ambiente sandbox do 4Geeks Perks.

Casos de Uso Comuns¶

Cenário 1: Integração (Onboarding) Automatizada¶

Situação: Uma empresa de tecnologia em rápido crescimento contrata 10 novos desenvolvedores todo mês. Criar manualmente as carteiras de benefícios para cada um é tedioso. Solução: Ao integrar com seu HRIS, assim que um novo contratado é marcado como “Ativo” no sistema de RH, o 4Geeks Perks cria automaticamente seu perfil e atribui o pacote de benefícios padrão de “Nova Contratação”. Resultado: O novo funcionário recebe seu 4Geeks Perks Card digital via e-mail no primeiro dia, sem intervenção manual do RH.

Cenário 2: Desligamento (Offboarding) Instantâneo¶

Situação: Um funcionário se demite e o RH esquece de cancelar o cartão de benefícios, levando a gastos não autorizados em refeições após sua saída. Solução: Com a integração habilitada, marcar o funcionário como “Desligado” no sistema de RH dispara uma atualização imediata de status no 4Geeks Perks. Resultado: A carteira do funcionário é congelada instantaneamente, impedindo qualquer uso pós-emprego e economizando custos.

Solução de Problemas¶

Problema 1: Os dados dos funcionários não estão sincronizando¶

• Causa: O intervalo de sincronização pode não ser imediato (alguns sistemas sincronizam a cada 24 horas), ou as permissões foram revogadas.
• Solução: Verifique o timestamp de “Last Sync” em suas Configurações de Integração. Frequentemente, você pode forçar uma ação de “Sync Now”. Se isso falhar, verifique se o aplicativo 4Geeks ainda possui permissões de “Leitura” no seu HRIS.

Problema 2: Erro “User already exists” (Usuário já existe)¶

• Causa: Você criou manualmente um usuário no 4Geeks Perks antes que a integração tentasse importá-lo.
• Solução: O sistema geralmente faz a correspondência pelo endereço de e-mail. Certifique-se de que o e-mail no seu sistema de RH corresponda ao criado manualmente. Se o problema persistir, entre em contato com o suporte para mesclar os registros.

Problema 3: Novos contratados não estão recebendo o e-mail do Perks Card¶

• Causa: O perfil do usuário foi criado, mas o gatilho “E-mail de Boas-vindas” pode estar desativado.
• Solução: No 4Geeks Console, vá em Perks > Settings > Notifications e certifique-se de que o e-mail “New User Welcome” esteja ativo.

Conclusão¶

Integrar o 4Geeks Perks com seu software de RH transforma a gestão de benefícios de uma tarefa manual em uma vantagem estratégica automatizada. Ao garantir a precisão e a pontualidade dos dados, você melhora a experiência do funcionário enquanto protege os recursos da empresa.

Precisa de ajuda com uma integração complexa? * Explore: Documentação 4Geeks para referências de API. * Contate: Fale com nossa Equipe de Suporte para assistência guiada na implementação.

• Ainda tem dúvidas? Pergunte na comunidade..
• Consulte el changelog.