Passar para o conteúdo principal
Todas as coleçõesIntegraçõesIntegrações de recrutamentoSAP SuccessFactors ATS
Instruções de Integração do SAP SuccessFactors – Módulo de Recrutamento
Instruções de Integração do SAP SuccessFactors – Módulo de Recrutamento
Sam Abello avatar
Escrito por Sam Abello
Atualizado essa semana

Escopo do trabalho

A plataforma de contratação de alto volume da Grayscale foi projetada para ajudar os recrutadores a simplificar e automatizar uma experiência de alto contato com o candidato em escala. A plataforma de recrutamento conversacional da Grayscale facilita o envio de mensagens de texto aos candidatos a partir do SAP SuccessFactors, ao mesmo tempo em que automatiza as tarefas repetitivas do processo de contratação.Este documento descreve o escopo do trabalho para implementar nossa solução dentro do seu ATS.


Etapas de integração

    1. Ativar Sincronização de Transcrição

    2. Adicionar pergunta de consentimento para SMS

    1. API Server URL

    2. Nome de usuário do SAP SuccessFactors

    3. ID da empresa

    4. ID do cliente

    5. Segredo do Cliente

    6. Pergunta sobre consentimento por SMS

      1. Field ID

      2. Sim

      3. Opção "Não" ID


Antes de integrar, há algumas permissões que precisamos configurar para habilitar todas as funcionalidades que precisamos. Veja as etapas descritas abaixo.


1.Configuração do Perfil do Candidato


Nota: Um usuário de implementação do SuccessFactors com acesso administrativo precisará completar essas tarefas.

A integração com o Grayscale precisará de acesso a dois campos no Perfil do Candidato para sincronização de transcrições e gerenciamento de consentimento de SMS:

  1. A sincronização de transcrições utiliza um Campo Padrão rotulado como "Comments"

  2. O gerenciamento de consentimento por SMS utiliza um Campo Personalizado

Para habilitar ambos campos no Template de Perfil do Candidato:

  1. Procure e selecione Gerenciar Modelos

  2. Na aba Gerenciamento de Recrutamento, selecione Perfil do Candidato

  3. Clique no nome do modelo de perfil que você quer editar

  4. Na página principal de Configurações do Template, role até o final da tela. Selecione o botão {N} Campos definidos. Clique para modificar

  5. Para ativar a Sincronização de transcrições

    1. Selecione Adicionar > Adicionar campo padrão no menu suspenso na parte superior do modal

    2. No novo formulário de campo, insira:

      1. Field id: “comments”

      2. Field type: “text”

      3. Rótulo do Campo: “Comentários”

  6. Para Gerenciamento de Consentimento por SMS

    1. Adicione um novo Campo Personalizado – cole valores para o ID do Campo e ID da Lista de Opções (preste atenção à estrutura de maiúsculas e minúsculas)

      1. Field id: Grayscale_sms_consent

      2. Tipo de Campo: picklist

      3. Rótulo do Campo: [Insira a Redação da Pergunta de Consentimento por SMS]

        1. Exemplo:
          "Você gostaria de optar por receber mensagens de texto do recrutador para esta função em relação ao processo de contratação, como solicitações de entrevistas, lembretes etc.?
          Observação: a seleção de "não" não o eliminará da consideração para essa função. Taxas de mensagens e dados podem ser aplicadas, dependendo do seu plano de serviço de telefonia móvel. A qualquer momento, você pode obter mais ajuda respondendo HELP a esses textos, ou pode optar por não participar completamente respondendo STOP.

      4. Descrição do Campo: (opcional) smsConsentPicklist

      5. Obrigatório: True*

        1. *Nossa recomendação para configurar este campo é marcá-lo como obrigatório – mas pode ser deixado como opcional se isso for atrapalhar seu fluxo de trabalho atual.

      6. Anonimizar: Falso

      7. É Sensível: Falso

      8. ID da lista de opções: Selecione uma opção de lista de opções Sim/Não apropriada para sua organização

  7. Clique em Concluído

  8. No menu superior, clique em Publicar

  9. Confirme as alterações clicando em Sim

Nota: Alguns avisos podem ser exibidos relacionados à configuração do perfil existente, mas as alterações já terão sido aplicadas.

Verificar Permissões de Sincronização de Transcrição

As transcrições de conversas em Grayscale serão publicadas no perfil do candidato por meio da API.Aqui estão as permissões de campo necessárias para permitir que as transcrições de conversas sejam visíveis no perfil do candidato internamente:

  • [Insira uma descrição para a permissão de campo]

  • Tipo *: Permissão de Leitura

  • Nome do grupo: [Selecione um grupo dinâmico para o qual essa permissão seja aplicável. Esses são os grupos dinâmicos definidos na instância. Se nenhum nome de grupo for selecionado, a permissão será aplicada ao Candidato por padrão

  • Países/Regiões *: [Selecione os países/regiões dos candidatos para os quais esta permissão é aplicável]

  • Fontes *: QUALQUER

  • Campos *: • Comentários selecionados

  • Elementos do plano de fundo: Nenhum

Os comentários dos candidatos agora devem estar visíveis no perfil do candidato!


2. Atribuir Permissões ao Usuário de Integração


Para garantir que o Grayscale tenha acesso aos dados necessários, atribua permissões específicas ao usuário de integração no SAP SuccessFactors.

  1. Criar ou Selecionar um Papel:

    • Vá para o Centro de Administração > Gerenciar Funções de Permissão.

    • Crie um novo cargo (por exemplo, "Grayscale Integration") ou selecione um existente.

  2. Atribuir Permissões: Expanda a seção apropriada abaixo para adicionar permissões

    • Dentro do papel, vá para Permissões e localize as permissões nas suas respectivas categorias conforme descrito abaixo.

    • Permissões de Recrutamento:

      • Exportação de requisição de trabalho da API OData

      • Exportação de Aplicativo API OData

      • API OData Criar/Atualizar Entrevista Central

      • Exportação de Candidatos via API OData

      • OData API Candidate Create


3.Reunir Valores de Integração


Precisaremos dos seguintes valores para configurar a integração:

  • API Server URL

  • Nome de usuário do SAP SuccessFactors

  • ID da empresa

  • ID do cliente

  • Segredo do Cliente

API Server URL

Usando seu URL de login, você pode encontrar o URL do Servidor API correspondente visitando este link.

  • Seu URL do servidor da API do SAP SuccessFactors é um URL que está intimamente relacionado ao URL de login onde você acessa a instância do SAP SuccessFactors da sua empresa.

  • Por exemplo, se você efetuar login em " https://acme.successfactors.com/login ", sua URL de login será acme.successfactors.com (o valor depois de "https://" e antes de "/login").

  • Normalmente, acrescentar "api" antes do URL de login resultará no URL correto do servidor de API (por exemplo, apiacme.successfactors.com ).

Nome de usuário e ID da empresa SAP

Para encontrar seu nome de usuário e ID da empresa do SAP SuccessFactors , você pode procurar no e-mail de boas-vindas do SAP SuccessFactors em "Nome de usuário da empresa" (veja a imagem abaixo):

  • Você também pode encontrar o ID da sua empresa no SAP SuccessFactors como parte do URL de login, que também é enviado para você no seu e-mail de boas-vindas do SAP SuccessFactors (em "Link da Empresa" - veja a imagem abaixo)

  • Alternativamente, você pode encontrar seu ID da Empresa do SAP SuccessFactors fazendo login no SAP SuccessFactors, passando o mouse sobre sua foto de perfil para expandir o menu suspenso, clicando em "Mostrar informações da versão" e localizando o ID da Empresa no modal que aparece:

    Não foi possível exibir o conteúdo

ID do cliente e segredo do cliente

  1. Efetue login na sua instância SAP

  2. Procure Gerenciar Aplicativos Cliente OAuth2 na barra de pesquisa

  3. Clique em Registrar Aplicativo do Cliente

  4. Preencha Nome do Aplicativo (Grayscale) & URL do Aplicativo (https://app.gograyscale.com) e clique em Gerar Certificado X.509

  5. Preencha o Nome Comum (Grayscale) e clique em Gerar

  6. Depois que a tela for atualizada, clique em Download

    • Isso fará o download de um arquivo chamado Certificate.pem

  7. Clique em Registrar

    • Agora você verá sua aplicação listada. Clique em Ver.

    • Agora você verá uma chave de API listada - esta é sua ID de cliente

  • Abra o arquivo "Certificate.pem" que você baixou anteriormente em um editor de texto.

    1. Renomeie o Certificate.pem para Certificate.txt e clique duas vezes para abrir

    2. Copie a string entre ——BEGIN ENCRYPTED PRIVATE KEY——- e —-END ENCRYPTED PRIVATE KEY——- isso é o seu Client Secret


IDs de Consentimento de SMS

Para ativar o gerenciamento de consentimento de SMS, vamos precisar dos seguintes valores:

  1. Field ID

    • Ou seja, Grayscale_sms_consent

  2. ID da opção do valor da lista suspensa "Yes"

    • Ou seja, 1234

  3. ID da opção do valor da lista suspensa "No"

    • Ou seja, 1235

Para localizar os IDs das Opções do Picklist:

  1. Procure e selecione Picklist Center

  2. Digite o valor do ID do Picklist na barra de pesquisa e selecione o picklist correspondente de Sim/Não

  3. Selecione a linha ativa

  4. Selecione o valor que representa a ação negativa, ou seja, “Não”

  5. Colete o valor do ID da Opção

  6. Repita os passos 4 e 5 selecionando a ação afirmativa, ou seja,Sim

Opções de Aplicação de Consentimento por SMS

Existem 3 níveis de aplicação de consentimento disponíveis no Grayscale.Por favor, avise seu Gerente de Implementação sobre sua escolha:

  1. Sem aplicação. Os usuários gerenciarão por conta própria, identificando e respeitando manualmente a resposta de cada candidato antes de enviar uma mensagem de texto. Eles podem enviar mensagens de texto para qualquer candidato, a menos que ele tenha optado por não participar diretamente via SMS (ou seja, respondido com "STOP" ou "UNSUBSCRIBE"). Ainda é responsabilidade do cliente coletar o consentimento.

  2. Aplicação permissiva. Os usuários não poderão enviar mensagens para candidatos que responderam NÃO à pergunta de consentimento.

    • Candidatos que enviaram uma inscrição antes da coleta do consentimento para SMS podem continuar sendo comunicados.

    • Os candidatos que responderam com YES à pergunta de consentimento por SMS podem ser comunicados.

  3. Aplicação rigorosa ou total. Os usuários só poderão se comunicar com candidatos que tenham respondido SIM à pergunta de consentimento por SMS.

    • Os usuários não poderão começar ou continuar a comunicação com candidatos que responderam NÃO à pergunta de consentimento para SMS.

    • Os usuários não poderão iniciar ou continuar a comunicação com candidatos que não tenham feito uma escolha na questão de consentimento por SMS.

      • Isso normalmente se aplica aos candidatos que enviaram suas inscrições antes da inclusão do questionário SMS.


Solução de problemas de permissões do OData

Às vezes, para que as permissões e ajustes de autenticação acima entrem em vigor, é necessário um "Atualização de Metadados OData".

  1. Faça login no SuccessFactors

    1. Procure por refresh e selecione Refresh em Atualização e Exportação de Metadados da API OData?

  2. Se a API da sua organização tiver restrições de acesso por IP, um administrador precisará permitir que nossos servidores se comuniquem com a API da SAP. Faça isso adicionando os valores descritos nesta documentação da SAP.

  3. Para adicionar os endereços IP do Grayscale:

    1. No SuccessFactors, procure e selecione Política de Senha & Login

    2. Clique em Definir Exceções de Login da API e expanda para encontrar o Grayscale Admin User

    3. Clique no Ícone de Lápis para Editar

    4. Cole esses Endereços IP separados por vírgula:

      • 3.225.131.100

      • 52.205.52.97

      • 3.75.58.147

      • 35.159.188.68

  4. Clique em Salvar e Fechar

Respondeu à sua pergunta?