Conectar o Djinni ao RolePark
O RolePark publica suas vagas no Djinni e traz as candidaturas para a caixa de entrada do RolePark. Basta uma chave de API do Djinni: o RolePark é o ATS, sem necessidade de desenvolvedor.
Atualizado:
Antes de começar
- Uma conta de empregador no Djinni com acesso à API. Abra https://djinni.co/home/profile/: se a empresa tiver acesso, a aba “ATS” aparece. Se não aparecer, escreva para o suporte do Djinni: magic@djinni.co.
- Uma conta de administração da empresa no RolePark. Só a administração conecta o Djinni.
- Uma chave de API do Djinni por empresa, sem vínculo com uma pessoa.
Passo 1. Crie uma chave de API no Djinni
- Abra https://djinni.co/home/integrations/ (aba “ATS” do perfil no Djinni).
- Clique em “Створити ключ” / “Create key” e copie a chave.
- Ative “Увімкнути поле ATS Job ID у вакансіях” (campo ATS Job ID): o Djinni devolve o id da vaga do RolePark com cada candidatura.
O botão vermelho “Delete” remove a chave; o RolePark para de publicar até receber uma nova.
Passo 2. Cole a chave no RolePark
- No RolePark, abra Configurações → Sites de vagas → Djinni.
- Cole a chave em “Chave de API do Djinni” e clique em “Conectar”. O RolePark verifica a chave na hora.
- Escolha os valores que o Djinni exige: recrutador no Djinni (um e-mail da sua lista no Djinni), setor e categoria. Clique em “Salvar valores padrão”.
Depois de salva, a chave aparece só com os quatro últimos caracteres.
Passo 3. Webhook de candidaturas
O RolePark cria o webhook no Djinni automaticamente pela API assim que a chave é verificada.
Se preferir adicionar manualmente, abra Djinni → ATS → Webhooks e informe:
| URL | o endereço do cartão Djinni no RolePark |
|---|---|
| Action | Candidate Apply |
| Autenticação | Header (cabeçalho próprio) |
| Header Name | X-RolePark-Webhook-Token |
| Authentication Value (Token) | o token do cartão Djinni no RolePark |
| Send as JSON | ativado |
Cada empresa tem endereço e token próprios; o RolePark confere o token em cada solicitação.
Publicar uma vaga
- Abra a vaga no RolePark → aba “Divulgação” → painel “Djinni”.
- Se faltar algo obrigatório, o painel mostra. Para publicar, o Djinni exige uma faixa salarial (de e até); um rascunho pode ficar sem ela. O RolePark envia a faixa da vaga só se estiver em dólares americanos por mês; caso contrário, informe-a em “Campos do Djinni para esta vaga”.
- Clique em “Publicar no Djinni”: o RolePark cria o anúncio no Djinni e o publica em um só passo. “Salvar como rascunho no Djinni” cria um rascunho inativo que não aparece; publique depois com “Publicar no Djinni”.
- O Djinni modera novos anúncios; enquanto isso, o status é “Em moderação no Djinni”.
Status no RolePark
- Na fila — a solicitação está a caminho do Djinni.
- Rascunho — existe no Djinni, mas não está visível.
- Em moderação no Djinni — o Djinni está revisando.
- Publicada — visível no Djinni.
- Pausada no Djinni — a vaga está pausada; o anúncio fica inativo no Djinni e volta quando a vaga reabrir.
- Erro — o Djinni recusou; o motivo aparece ao lado do status.
- Removida — arquivada no Djinni.
- Ao editar a vaga no RolePark, o anúncio no Djinni é atualizado.
- Ao pausar a vaga, o RolePark pausa o anúncio no Djinni e o reativa quando a vaga volta a ficar aberta. Ao fechar, despublicar ou excluir a vaga, o RolePark a remove do Djinni.
- Se o Djinni estiver indisponível, o RolePark tenta de novo e respeita o limite de 100 solicitações por minuto.
Onde as candidaturas aparecem
- O Djinni envia cada nova candidatura ao RolePark pelo webhook assim que ela chega; a cada 15 minutos o RolePark também verifica cada vaga publicada.
- Elas aparecem na vaga → aba “Caixa de entrada” com a etiqueta “Djinni” e um link para o perfil.
- Se a mesma pessoa chegar também por e-mail do Djinni, o RolePark a reconhece pelo link do perfil e não duplica.
Quais dados são transferidos
RolePark → Djinni
- título, descrição, habilidades, local e formato de trabalho;
- faixa salarial (pública só se for pública no RolePark), setor, categoria e recrutador;
- o id da vaga do RolePark (ATS Job ID).
Djinni → RolePark
- nome e contatos, se compartilhados; link do perfil, CV, carta e data.
- Não importamos gênero, adiamento militar, foto, mensageiros nem respostas de questionários.
- A chave de API é armazenada criptografada (AES-256-GCM) e não volta a ser exibida nem registrada em logs.
- Desconectar remove a chave e o webhook.
Solução de problemas
“Chave inválida”
A chave foi excluída no Djinni. Crie outra e cole em “Substituir chave”.
“Limite de solicitações do Djinni”
O Djinni permite 100 solicitações por minuto. O RolePark aguarda e continua sozinho.
O Djinni recusou a vaga
O motivo aparece no painel da vaga. Corrija e clique em “Tentar novamente”.
O webhook está desativado no Djinni
Clique em “Verificar chave” no RolePark para configurá-lo de novo.
Não há aba “ATS” no Djinni
Escreva para o suporte do Djinni: magic@djinni.co.
Suporte
Dúvidas sobre o RolePark: help@rolepark.com
Acesso à API do Djinni: magic@djinni.co.