IBM Kenexa BrassRing - Integração de Entrevistas

Last updated: May 27, 2026

Visão Geral

O diagrama abaixo descreve o fluxo de trabalho da integração entre BrassRing e HackerRank Interviews para recrutadores. Os recrutadores moverão um candidato para um status personalizado de Entrevista HackerRank. Ao entrar neste status, o BrassRing enviará uma carga útil para o HackerRank através da API de Exportação de Candidatos. O HackerRank então gerará uma nova URL de Entrevista e link de Agendamento e responderá de volta ao BrassRing. O Recrutador pode usar a URL de Entrevista diretamente em sua própria ferramenta de agendamento. Opcionalmente, eles podem acessar o link de agendamento para configurar uma data e hora dentro do HackerRank. O HackerRank então enviará o convite do calendário automaticamente. Após a Entrevista ter ocorrido, um link para o relatório da Entrevista será enviado de volta ao BrassRing através da API de Importação de Formulários.

Etapas de Integração

A integração envolve um processo de 3 etapas:

  • Etapa 1: Configurar a Exportação de Candidatos para gerar os links de Entrevista

  • Etapa 2: Configurar a Importação de Formulário para aceitar os links de Entrevista

  • Etapa 3: Configurar a Importação de Formulário para aceitar a url do relatório de Entrevista

Configure a Exportação de Candidatos para gerar os links de Entrevista

Obtenha a chave da API BrassRing do HackerRank for Work

Nota: Se você estiver usando a integração BrassRing Tests, pode pular esta etapa e reutilizar a conexão para as seguintes exportações de candidatos.

  1. Faça login no HackerRank for Work com a conta de usuário Administrador da Empresa.

  2. Na página inicial, clique no menu suspenso ao lado do ícone do usuário no canto superior direito.

  3. Clique em Configurações.

    settings.png
  4. No painel esquerdo, clique em Integrações. A página Integrações é exibida. Role para baixo e clique em Configurar na opção BrassRing. Você também pode pesquisar a Integração na barra de pesquisa.

    integ_brassring1.png
  5. Clique em Gerar Token da API para gerar o token da API.

    integ_brassring_api.png

    Uma Chave de API única é exibida.

    integ_brassring_api_token.png
  6. Copie esta chave. Você precisará adicionar esta chave à conta BrassRing para estabelecer a integração.

Nota: Certifique-se de armazenar a chave da API com segurança. Uma vez que o popup seja fechado, você não poderá recuperar a chave novamente.

Configuração de URL e Autenticação

No BrassRing, crie um novo payload de Exportação de Candidatos. Ele deve ser enviado para a seguinte URL:

PROD: https://ats.hackerrank.com/brassring-codepair/v3/schedule-codepair

STAGE: https://ats.hackerrank.com/brassring-codepair-stage/v3/schedule-codepair

O nome de usuário para esta exportação deve ser definido como a chave da API BrassRing gerada dentro do HackerRank. (O campo de senha não é usado pelo HackerRank e pode ser definido com qualquer valor se for um campo obrigatório.)

Nota - A chave da API pode ser mais longa do que os campos de nome de usuário e senha permitem. Se este for o caso, você precisará fazer uma solicitação ao seu representante de integração da IBM para que seja configurada pela IBM.

Configurar Payload XML de Exportação de Candidatos

Este é o formato para o XML de Exportação de Candidatos que é compreendido pelo HackerRank imediatamente. Você precisará configurar o Workbench para criar um XML correspondente:

<?xml version="1.0" encoding="UTF-8"?>
 
 <Envelope version="01.00">
 
   <Sender>
 
     <Id></Id>
 
     <Credential>26059</Credential>
 
   </Sender>
 
   <Recipient>
 
     <Id>http://server123.testcompany.com:8044/b2bhttp/inbound/kenexa</Id>
 
   </Recipient>
 
   <!-- URL de destino onde os dados serão enviados -->
 
   <TransactInfo transactType="data">
 
     <TransactId>HSCAND19681</TransactId>
 
     <TimeStamp>2019-08-23 14:23 PM</TimeStamp>
 
   </TransactInfo>
 
   <Packet>
 
     <PacketInfo packetType="data">
 
       <PacketId>1</PacketId>
 
       <Action>SET</Action>
 
       <Manifest>CODEPAIR_CANDIDATE</Manifest>
 
     </PacketInfo>
 
     <Payload><![CDATA[<?xml version="1.0"?>
 
 <CODEPAIR_CANDIDATE>
 
         <CANDIDATEID></CANDIDATEID>
 
         <REQUISITIONNUMBER></REQUISITIONNUMBER>
 
         <BRREQNUMBER></BRREQNUMBER>
 
         <JOBCODE></JOBCODE>
 
         <STATUS></STATUS>
 
   <EMAIL></EMAIL>
 
   <FIRSTNAME></FIRSTNAME>
 
   <LASTNAME></LASTNAME>
 
 </CODEPAIR_CANDIDATE>
 
 ]]></Payload>
 
   </Packet>
 
   <Packet>
 
     <PacketInfo packetType="data">
 
       <PacketId>2</PacketId>
 
       <Action>SET</Action>
 
       <Manifest>CODEPAIR_CANDIDATE_REQEXPORT</Manifest>
 
     </PacketInfo>
 
     <Payload><![CDATA[<CODEPAIR_CANDIDATE_REQEXPORT language="en">
 
         <REQFORM id="111"></REQFORM>
 
   <CHOOSE_CODEPAIR></CHOOSE_CODEPAIR>
 
 </CODEPAIR_CANDIDATE_REQEXPORT>
 
 ]]></Payload>
 
   </Packet>
 
 </Envelope>

Campos Obrigatórios do Sistema

Dados enviados da Exportação de Candidatos:

Nome do Campo

Formato

Nota

EMAIL

Varchar

Este é o endereço de email do candidato. O HackerRank precisa disso para vincular a entrevista ao candidato

FIRSTNAME

Varchar

Primeiro Nome do Candidato.

LASTNAME

Varchar

Sobrenome do Candidato.

Resposta de Exportação de Candidato

Nome do Campo

Formato

Nota

Descrição Longa

Varchar

Link de agendamento: (link) Link da entrevista: (link curto)

Enviar Pré-visualização do Payload XML de Exportação de Candidatos para o HackerRank

Uma vez que a configuração do Workbench esteja completa, gere o XML de exemplo e envie para o HackerRank para validação.

Configure a Importação de Formulário para aceitar os links de Entrevista

Configurar Payload XML de Importação de Formulário

Este é o formato para o XML de Importação de Formulário que é enviado do HackerRank pronto para uso. Você precisará configurar o Workbench para criar um XML correspondente:

<?xml version="1.0" encoding="UTF-8"?>

<Envelope version="01.00">

  <Sender>

    <Id>HRXMLEMPLID</Id>

    <Credential>26059</Credential>

  </Sender>

  <Recipient>

    <Id />

  </Recipient>

  <TransactInfo transactType="data">

    <TransactId>15747</TransactId>

    <TimeStamp>2019-08-23 14:26 PM</TimeStamp>

  </TransactInfo>

  <Packet>

    <PacketInfo packetType="data">

      <PacketId>1</PacketId>

      <Action>SET</Action>

      <Manifest>CODEPAIR_LINKS</Manifest>

    </PacketInfo>

    <Payload><![CDATA[<?xml version="1.0"?>

<form formTypeId="376" formName="HackerRank_CodePair_Results" formId="" action="Insert" resumeKey="" FirstName="" LastName="" email="" homePhone="" language="EN" autoreq="" optionalreq="">

<!--a ação do formulário pode ser "Insert" ou "Update"-->

<FormInput name="(gerado pelo BR)" title="Link de Agendamento CodePair"></FormInput>

<FormInput name="(gerado pelo BR)" title="Link de Entrevista CodePair"></FormInput>

<FormInput name="(gerado pelo BR)" title="Primeiro Nome"></FormInput>

<FormInput name="(gerado pelo BR)" title="Último Nome"></FormInput>

<FormInput name="(gerado pelo BR)" title="ID da Requisição"></FormInput>

</FormInput>

</form>]]></Payload>

  </Packet>

</Envelope>

Campos de Formulário Personalizados

Nome do Campo

Formato

Nota

Link de Agendamento da Entrevista

Varchar

url para agendar a Entrevista

Link da Entrevista

Varchar

Url para iniciar a entrevista. Pode ser colado em um convite de calendário.

Enviar Visualização de Payload XML de Importação de Formulário para HackerRank

Os seguintes campos são gerados pelo BrassRing e serão específicos do ambiente:

  • campo formTypeID

  • campo formName

  • Cada campo name do FormInput

Uma vez que o payload XML é criado, você deve enviar um XML de visualização para o HackerRank para que os identificadores corretos possam ser enviados do HackerRank for Work.

Configure a Importação de Formulário para aceitar a url do relatório de Entrevista

Configurar Payload XML de Importação de Formulário

Este é o formato para o XML de Importação de Formulário que é enviado do HackerRank pronto para uso. Você precisará configurar o Workbench para criar um XML correspondente:

<?xml version="1.0" encoding="UTF-8"?>

<Envelope version="01.00">

  <Sender>

    <Id>HRXMLEMPLID</Id>

    <Credential>26059</Credential>

  </Sender>

  <Recipient>

    <Id />

  </Recipient>

  <TransactInfo transactType="data">

    <TransactId>15747</TransactId>

    <TimeStamp>2019-08-23 14:26 PM</TimeStamp>

  </TransactInfo>

  <Packet>

    <PacketInfo packetType="data">

      <PacketId>1</PacketId>

      <Action>SET</Action>

      <Manifest>CODEPAIR_RESULTS</Manifest>

    </PacketInfo>

    <Payload><![CDATA[<?xml version="1.0"?>

<form formTypeId="376" formName="HackerRank_CodePair_Results" formId="" action="Insert" resumeKey="" FirstName="" LastName="" email="" homePhone="" language="EN" autoreq="" optionalreq="">

<!--a ação do formulário pode ser "Insert" ou "Update"-->

<FormInput name="(gerado pelo BR)" title="Nome da Avaliação"></FormInput>

<FormInput name="(gerado pelo BR)" title="Status do Candidato"></FormInput>

<FormInput name="(gerado pelo BR)" title="Feedback"></FormInput>

<FormInput name="(gerado pelo BR)" title="Primeiro Nome"></FormInput>

<FormInput name="(gerado pelo BR)" title="Último Nome"></FormInput>

<FormInput name="(gerado pelo BR)" title="ID da Requisição"></FormInput>

<FormInput name="(gerado pelo BR)" title="Data da Avaliação"></FormInput>

<FormInput name="(gerado pelo BR)" title="Link para a Página de Resumo da Avaliação"></FormInput>

</form>]]></Payload>

  </Packet>

</Envelope>

Campos de Formulário Personalizados

Nome do Campo

Formato

Nota

Feedback

Varchar

Este é o texto que é definido durante a entrevista

Status do Candidato

Varchar

Enviaremos o status da entrevista. Por exemplo: Qualificado, Reprovado, Avaliação Necessária

Link do Relatório

Varchar

url para o relatório

Enviar Visualização de Payload XML de Importação de Formulário para HackerRank

Os seguintes campos são gerados pelo BrassRing e serão específicos do ambiente:

  • campo formTypeID

  • campo formName

  • Cada campo name do FormInput

Uma vez que o payload XML é criado, você deve enviar um XML de visualização para o HackerRank para que os identificadores corretos possam ser enviados do HackerRank for Work.