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.
Faça login no HackerRank for Work com a conta de usuário Administrador da Empresa.
Na página inicial, clique no menu suspenso ao lado do ícone do usuário no canto superior direito.
Clique em Configurações.
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.
Clique em Gerar Token da API para gerar o token da API.
Uma Chave de API única é exibida.
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 |
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.