Integração InHire + DigAI

Integração InHire + DigAI

A integração acontece via comunicação entre APIs: do lado da InHire são configurados webhooks que disparam a cada atualização importante; do lado da DigAI, eventos são enviados para a API da InHire ao final do processo para entregar o resultado.

Etapa 1 — Criação de vagas

As vagas são criadas pelo dashboard da InHire e precisam obrigatoriamente ter uma etapa personalizada com a palavra-chave "entrevista inteligente".

Em até 5 minutos, uma triagem em rascunho é criada automaticamente no painel da DigAI com o mesmo nome. Essa triagem precisa ser revista por uma pessoa, que adiciona as perguntas, finaliza as configurações e publica.

Atenção: vagas que não tiverem a etapa cadastrada no momento da criação não serão duplicadas pela DigAI. Cuide da ortografia e de espaços excessivos no nome da etapa.

Onde posicionar: a recomendação é inserir logo após a candidatura inicial, para que a entrevista da DigAI receba todos os candidatos.

Etapa 2 — Captura de candidatos

Começa quando os candidatos são movidos para a etapa da DigAI. Em até 30 minutos, eles são convidados a iniciar a triagem. Esta etapa não exige nenhuma configuração adicional — a partir daí, os próximos candidatos movidos já ficam aptos automaticamente.

Etapa 3 — Envio de resultados

Após a triagem, o resultado é enviado à InHire via tag e comentário em até 5 minutos. O comentário exibe a nota do candidato e um link para acessar detalhes e insights no dashboard da DigAI. O autor do comentário é o usuário criado para a integração.

Permissões necessárias

São necessárias as credenciais de um usuário de API com as permissões corretas, que pode ser solicitado diretamente à InHire.

O ideal é um usuário neutro, não relacionado a nenhuma pessoa real da plataforma — todas as ações da integração levam a assinatura dele, inclusive os comentários.

As credenciais não são salvas: por segurança, apenas o refreshToken fica no banco de dados. Tudo seguindo a documentação oficial da InHire e com o suporte oficial deles.

O que a integração acessa

Apesar de o usuário de API ter permissões mais amplas, a integração faz apenas estas ações:

| Ação | Endpoint | |---|---| | Autenticação | POST /refresh | | Visualizar vagas | GET /jobs · GET /jobs/{jobId} | | Criar comentários | POST /job-talents/talents/{jobTalentId}/activities | | Visualizar/criar tags | GET e POST /jobs/{jobId}/tags | | Criar webhooks | POST /integrations/webhooks |

Os webhooks criados são dois: JOB_ADDED, disparado ao criar vagas, e JOB_TALENT_STAGE_ADDED, disparado ao avançar candidato.