Passar para o conteúdo principal
Todas as coleçõesRecursos do SAP SuccessFactorsRecursos de Integração
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 há mais de uma 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 em 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 de SMS Consentimento

      1. Field ID

      2. Opção "Sim" ID

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


Atualmente, estamos fazendo parceria com a empresa Merge, e antes de integrar, há algumas permissões que precisamos configurar para habilitar todas as funcionalidades que precisamos. Veja as etapas descritas abaixo.


Configuração do Perfil do Candidato


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

A integração do 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 chamado "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 de 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 no topo do modal

    2. No formulário de novo 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 & ID da Lista de Opções (observe a estrutura de maiúsculas e minúsculas)

      1. Field id: Grayscale_sms_consent

      2. Tipo de Campo: picklist

      3. [Digite a Redação da Pergunta de Consentimento para 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: Verdadeiro*

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

      6. 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: Podem ser exibidos alguns avisos relacionados à configuração de perfil existente, mas as alterações 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 das 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!


Verificar Permissões OData


Por padrão, os usuários só podem visualizar ou editar campos relevantes com base nas permissões de nível de campo definidas nos modelos de entidade. Essas permissões em nível de campo permitem que os operadores de Recrutamento realizem as mesmas ações usando APIs ODATA que eles realizam em entidades no SAP SuccessFactors Recruiting.

As seguintes permissões permitirão que o usuário da API do Grayscale visualize e edite todos os campos necessários para a integração do Grayscale, independentemente da relação do usuário integrador com essas entidades:

  1. Exportação de Requisição da API OData (OData API Requisition Export)

  2. Exportação de Aplicativo API OData (OData API Application Export)

  3. OData API Interview Central Criar/Atualizar (OData API Interview Central Create/Update)

  4. Exportação de Candidatos API OData (OData API Candidate Export)

  5. OData API Candidate Create (OData API Candidate Create)

  6. API da Fundação do Employee Central somente leitura (Employee Central Foundation API read only)

Resolvendo Problemas de Permissões Odata

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

  1. Faça login no SuccessFactors

    1. Procure por atualizar e selecione Atualizar em Atualizar e Exportar 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, pesquise e selecione Política de Senha & Login (Password & Login Policy)

    2. Clique em Definir Exceções de Login de API (Set API Login Exceptions) 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:

      1. 44.194.126.11

      2. 44.194.4.0

      3. 3.232.227.174

      4. 3.214.125.237

      5. 54.158.121.71

      6. 44.193.163.62

  4. Clique em Salvar e Fechar


Coletar Valores de Integração


1 – API Server URL

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

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

  2. Por exemplo, se você fizer login em "https://acme.successfactors.com/login", sua URL de login é acme.successfactors.com (o valor após "https://" e antes de "/login").

  3. Normalmente, adicionar "api" antes do seu URL de login resultará no URL correto do Servidor API (ou seja, apiacme.successfactors.com)


2 – Nome de Usuário SAP e ID da Empresa

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

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

    1. Por exemplo, se a URL de login for "https://successfactors.com/login?company=SFCPART00000", o ID da sua empresa será SFCPART000000.

  2. 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 na janela modal que aparece:


3 – Client ID e Client Secret

  1. Faça 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. Assim que a tela atualizar, clique em Download.

    1. Isso vai baixar um arquivo chamado Certificate.pem.

  7. Clique em Registrar.

    1. Agora você verá seu aplicativo listado. Clique em Ver.

    2. Agora você verá uma chave de API listada - este é o seu ID do Cliente.

  8. 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——- este é o seu Client Secret


4 – IDs de Perguntas de Consentimento de SMS

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

  1. Field ID (ID da Campo)

    • Ou seja, Grayscale_sms_consent

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

    • Ou seja, 1234

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

    • Ou seja, 1235

Para localizar os IDs das opções da lista de seleção:

  1. Procure e selecione Picklist Center

  2. Digite o valor do id do Pickist na barra de pesquisa e selecione a lista de opções Sim/Não correspondente

  3. Selecione a linha ativa

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

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

  6. Repita as etapas 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:

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

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

    • Candidatos que enviaram uma aplicação antes da coleta do consentimento para SMS podem continuar a ser comunicados.

    • Candidatos que responderam com SIM à pergunta de consentimento por SMS podem ser comunicados.

  3. Aplicação rigorosa ou total. 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.

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

      • Isso geralmente se aplica a candidatos que enviaram sua(s) aplicação(ões) antes da adição do questionário por SMS.

Respondeu à sua pergunta?