Passar para o conteúdo principal

Como integrar o TOTVS RH Atração de Talentos (ATS) com a Feedz?

Saiba como realizar a integração entre a solução de Recrutamento e Seleção e de Admissão Digital (DP).

Atualizado há mais de 2 semanas

A integração conecta o TOTVS RH Atração de Talentos à Feedz, inclusive ao módulo de Admissão Digital. Quando uma pessoa candidata é marcada como "Contratada" no ATS, seus dados são levados para a Admissão Digital da Feedz, onde o processo de admissão é iniciado.


Como habilitar a integração:

Na Feedz, acesse a página 'Configurações' clicando no botão do menu lateral.


No menu superior, clique em 'Integrações'.

Na página de integrações, siga este caminho:

Passo 1: dentro da Feedz, na seção "Chave de Integração (API 2.0)", clique em 'Gerar Token'.

⚠️ Lembre-se: o token é restrito por tipo de usuário. Então, apenas um usuário com papel de Administrador na empresa pode clicar no botão "Gerar Token".

Passo 2: para obter os dados: "client_id" e "client_secret", siga os passos abaixo no módulo de TOTVS ATS.

No menu lateral, clique em 'Configurações' e depois, 'Chaves de integração'.
Na tela seguinte, clique em 'Gerar chave'.

Chave gerada. Agora, copie e cole os dados, que serão usados na Feedz.

Retorne à Feedz e cole os dados copiados no passo anterior e depois. Por fim, ative a opção 'Ativar integração'.


Como funciona a integração automática com o módulo de Admissão Digital (DP):

1. Busca diária (automática): todos os dias, às 12h e 18h, a Feedz:

  • Procura no Atração de Talentos as pessoas candidatas com status = Contratado (Hired);

  • Insere esses registros na Admissão Digital.

2. Devolutiva de status (instantânea): ao mudar o status na Admissão Digital, a Feedz envia atualização de volta ao ATS:

  • Iniciado, Cancelado ou Efetivado.

Junto com o status, também é enviado:

  • Data e hora do evento;

  • ID da admissão digital;

  • ID da empresa;

  • ID do candidato.


Como executar a integração manual:

Use este recurso quando precisar antecipar a sincronização sem aguardar o horário das 12h.

Para isso, clique em 'Executar busca de candidatos manual'. O sistema irá rodar a integração fora da ação automática e seguindo as regras da integração, buscando colaboradores com o status "Contratado" no ATS e o insere na Admissão Digital da Feedz.


Sincronização de cargos, departamentos e unidades:

A Feedz envia automaticamente para o TOTVS RH Atração de Talentos (ATS) as unidades, departamentos e cargos cadastrados na sua conta. Isso garante que as duas plataformas permaneçam alinhadas e utilizem a mesma estrutura organizacional.

O disparo dessa integração é automático e acontece todos os dias às 1h AM. Para isso, na tela de Integrações da Feedz, ative a opção 'Sincronização de unidades, departamentos, cargos'.

Essa função também pode ser executada manualmente por meio do botão 'Realizar sincronização manual'. Assim, não será necessário aguardar o horário de 1h AM.

Essa integração envia cargos, departamentos e unidade cadastrados na Feedz para o ATS. Assim que o processo é concluído você receberá a notificação dentro da plataforma.

⚠️ Lembre-se: caso já exista uma sincronização em andamento (automática ou manual), o sistema bloqueia a ação e exibe uma mensagem informando que é necessário aguardar a finalização.


Sincronização de usuários e permissões:

Essa integração envia para o TOTVS RH Atração de Talentos (ATS) os usuários da Feedz e seus papéis de acesso no módulo de Recrutamento e Seleção. Para isso, ative a opção 'Sincronização de usuários e permissões'.

Após ativar a integração, um novo menu será exibido dentro do cadastro do colaborador, no caminho:

Pessoas > Colaboradores > Editar colaborador > Permissões > Recrutamento e Seleção.

Nesse menu, você pode definir os papéis de acesso que serão enviados ao ATS. Assim que as permissões são salvas, a Feedz envia automaticamente as informações para o ATS. Esse envio é imediato e qualquer falha é mostrada diretamente na tela para que você possa corrigir.


Campos importados:

Os seguintes dados são trazidos do Atração de Talentos para a Feedz:

  • ID do candidato

  • Nome

  • E-mail

  • CPF

  • Departamento

  • Cargo

  • Idioma

  • Prazo de Entrega

  • Tipo de contratação

⚠️ Lembre-se: o campo Prazo de entrega não existe no ATS, mas é obrigatório na Admissão Digital. A Feedz preenche automaticamente esse campo com um prazo padrão de 15 dias após a data atual.


Mapeamento de vínculo (ATS → Feedz):

ATS

Feedz

CLT

CLT

PJ

PJ

Estágio

Estágio

Cooperado

Cooperado

Freelancer

CLT

Múltiplos vínculos

CLT

Se a vaga permitir mais de um vínculo, a escolha final acontece no Admissão Digital.
Sempre que houver cenário inconclusivo, o vínculo será registrado como CLT por padrão. O mesmo vale para o tipo de vínculo “Freelancer”, ele será registrado como CLT.


Perguntas frequentes (FAQ):

1) Preciso ter o módulo DP contratado?

Sim. A integração de candidatos com a Admissão Digital só funciona para clientes que possuem o módulo de Departamento Pessoal.

2) O que acontece se eu tentar rodar manualmente enquanto já há execução em andamento?

O sistema exibe uma mensagem de bloqueio, pedindo para aguardar a finalização.

3) Como confirmar se minhas credenciais estão corretas?

Use o botão 'Verificar Credenciais' após inserir client_id e client_secret.

4) O vínculo do candidato pode vir errado?

Se a vaga permitir múltiplos vínculos, a definição ocorre na Admissão Digital. Caso não haja clareza, o padrão será CLT.

Respondeu à sua pergunta?