Pular para o conteúdo

Como conectar entrevistas com IA ao seu ATS, à API ou à página de carreiras.

Uma integração de entrevistas com IA ao ATS, a API pública com webhooks ou a entrevista incorporada à sua página de carreiras: o que cada uma faz, como escolher e como configurar e testar.

Atualizado em 17 de novembro de 2026 · 9 min de leitura

Nesta página

Em resumo

  • Três caminhos: uma conexão nativa com o ATS, a API pública com webhooks ou a entrevista incorporada à sua página de carreiras. Você pode usar mais de um.
  • ATS: vincule uma vaga e uma etapa no Workable, Greenhouse, Teamtailor, Recruitee ou Breezy HR a uma entrevista publicada. Cada candidato movido para essa etapa é convidado uma única vez, e os resultados voltam como uma nota.
  • API: crie candidatos e convites a partir dos seus próprios sistemas com uma chave de API de escopo limitado e saiba o que aconteceu por meio de webhooks assinados.
  • Incorporação: execute a entrevista dentro do seu próprio site com um único script, a partir dos sites que você autorizar.
  • Teste primeiro: envie um evento de teste de webhook, passe um candidato de teste pela etapa e leia os logs de entrega e de atividade antes de entrar em produção.

Três formas de conectar entrevistas com IA

Uma integração de entrevistas com IA ao ATS poupa seus recrutadores de copiar e colar: os candidatos são convidados a partir do sistema que você já usa, e os resultados voltam para ele. Se o seu ATS não tem conexão nativa, ou se você contrata pelo seu próprio portal, a API pública e a incorporação fazem o mesmo trabalho com um pouco de código.

  • Conexão nativa com o ATS. Workable, Greenhouse, Teamtailor, Recruitee e Breezy HR. Sem código: cole uma chave, vincule uma vaga e uma etapa, e mover um candidato para essa etapa envia o convite.
  • API pública e webhooks. O seu sistema cria candidatos e convites via REST e busca os resultados; os webhooks avisam quando algo acontece.
  • SDK de incorporação. Um script executa a entrevista em um frame na sua página de carreiras. Ele precisa de um link de convite, então é usado junto com a API.
Tutorial em vídeo, 3:16. Conectar o Greenhouse e vincular a etapa de uma vaga a uma entrevista; depois, o Slack, uma chave de API e um webhook. Em inglês, com legendas.

As três exigem um plano pago e um admin da empresa. A entrevista é a mesma que os candidatos recebem por um link no e-mail, incluindo a opção de digitar em vez de falar.

Como escolher entre o ATS, a API e a incorporação

Conexão nativa com o ATSAPI pública e webhooksSDK de incorporação (com a API)
Ideal paraEquipes que usam um dos cinco ATSs compatíveisQualquer outro ATS ou o seu próprio fluxoUma página de carreiras ou um portal que você controla
Código necessárioNenhumChamadas à API e um receptor de webhooksAlgumas linhas na página, mais a API
O que envia o conviteMover um candidato para a etapa vinculadaA sua chamada à APIA sua chamada à API; o link é montado na sua página
Os resultados voltam comoUma nota no candidato dentro do ATSResultados que você busca após o webhook de resultadosO mesmo; a página só fica sabendo que o candidato terminou

Comece pela conexão nativa se o seu ATS tiver uma. Escolha a API quando precisar controlar quem é convidado e quando. Adicione a incorporação quando os candidatos devem permanecer no seu site.

Configure a integração de entrevistas com IA ao ATS

Conecte um ATS e vincule uma vaga

  1. Publique a entrevista. Só uma entrevista publicada pode ser vinculada a uma vaga.
  2. Abra Integrações → ATS e clique em Conectar ATS. Cole as credenciais do ATS (onde encontrá-las). O testee as testa com o ATS antes de salvar, depois as armazena criptografadas e mostra apenas uma dica mascarada.
  3. Configure o webhook. Workable e Breezy HR não exigem nada: o testee o registra. Para Greenhouse, Teamtailor e Recruitee, adicione um webhook no ATS com o endereço do cartão Webhook da conexão e troque o segredo como o cartão indica.
  4. Vincule uma vaga. A aba Vagas lista as vagas abertas do ATS. Abra uma, escolha a entrevista publicada e a etapa que envia o convite, e salve.
  5. Marque as vagas da cidade de Nova York no vínculo, para que os convites levem o seu aviso da Local Law 144 e abram 10 dias úteis depois.
Uma conexão com o Workable: suas configurações, o webhook e as vagas vinculadas a entrevistas.
Uma conexão com o Workable: as configurações, o cartão do webhook e as vagas, cada uma vinculada a uma entrevista publicada.

O que acontece com cada candidato

  • Convidado uma única vez, não importa quantas vezes o ATS envie o evento. Eventos de vagas ou etapas que você não vinculou são ignorados.
  • Campos fixos: o e-mail e o nome do candidato, a vaga e a etapa, e a referência do ATS. Não há mapeamento para configurar.
  • Resultados como nota: a pontuação de cobertura (para revisão, não uma decisão de contratação), o resumo e um link para os resultados. Você pode desativar o retorno ao ATS em cada conexão.
  • Falhas: uma indisponibilidade é retentada por cerca de oito horas; uma recusa, como a falta de minutos de entrevista, aparece no log.
  • Tempo extra para um candidato que pediu é definido na página do convite no painel, até ele começar.

Pausar retém convites e notas até você retomar. Se depois o ATS recusar a chave, a conexão mostra É preciso reconectar e as notas ficam aguardando.

Use a API e os webhooks de entrevista com IA

A API REST pública faz o que um recrutador faz no painel: lista as entrevistas publicadas, cria candidatos, envia convites e busca resultados. A referência está na documentação da API de entrevista com IA.

Chaves de API

  • Crie uma chave em Integrações → Chaves de API. O segredo (aik_live_…) é mostrado uma única vez e enviado como bearer token, nunca em uma URL.
  • Escopos: dê a cada chave apenas as permissões que o sistema dela usa, como invitations:write e results:read.
  • Lista de IPs permitidos: até 50 endereços ou faixas, como os endereços de saída dos seus servidores.
  • Validade: 30 dias, 90 dias (o padrão), 1 ano, uma data em até 2 anos ou nunca. A lista avisa com 7 dias de antecedência.
  • Limite de requisições: 120 requisições por minuto por chave.
A aba Chaves de API com chaves ativas e revogadas, suas permissões e regras de IP.
A aba Chaves de API: as permissões e as regras de IP de cada chave, com as chaves revogadas mantidas como registro.

Convide um candidato a partir do seu sistema

  1. GET /v1/interviews lista suas entrevistas publicadas.
  2. POST /v1/candidates com o nome e o e-mail. Um segundo candidato com o mesmo e-mail é recusado, então guarde o id.
  3. POST /v1/invitations com os dois ids. A resposta contém o link, mostrado uma única vez; o testee também o envia por e-mail ao candidato.
  4. Envie um cabeçalho Idempotency-Key em todo POST. Uma nova tentativa com a mesma chave após um timeout não cria nada em duplicidade (as chaves valem por 24 horas).
Campo opcional do conviteO que faz
externalIdO seu próprio id (o da candidatura, por exemplo). Ele volta no convite e em todo webhook
returnUrlAo terminar, o candidato vê um botão para voltar a este endereço https (não dentro da incorporação)
extraTime25, 50 ou 100 por cento a mais de tempo para um candidato que pediu; uma entrevista dura no máximo 60 minutos, com o tempo extra incluído. Nunca é retornado pela API nem enviado em webhooks
nycNoticeO candidato mora na cidade de Nova York: o e-mail leva o seu aviso, e a entrevista abre 10 dias úteis depois
skipSignInO seu site já autenticou o candidato: só o link abre a entrevista (veja a incorporação)

Webhooks

Adicione um endpoint em Integrações → Webhooks: uma URL https pública e seus eventos, que são invitation.created, invitation.opened, invitation.resent, invitation.revoked, invitation.expired, session.started, session.completed, results.failed, review.decision_changed, candidate.erased e results.ready. Os payloads levam apenas ids e o seu externalId, nunca nomes ou pontuações; em results.ready, chame GET /v1/sessions/{id}/results.

  • Verifique todas as assinaturas: um HMAC-SHA256 do timestamp e do corpo bruto, com o segredo do endpoint como chave. Compare em tempo constante e rejeite timestamps com mais de 5 minutos (código na documentação de webhooks).
  • Responda 2xx em até 10 segundos. As falhas são reenviadas com backoff por cerca de 24 horas.
  • Espere repetições e qualquer ordem: ignore um id de evento que você já processou e leia o estado atual pela API.

Incorpore a entrevista na sua página de carreiras

Incorporar a entrevista na página de carreiras mantém os candidatos no seu site: um script coloca a entrevista em um frame e informa o que o candidato faz (documentação do SDK de incorporação).

Incorpore a entrevista

  1. Autorize o seu site em Integrações → Incorporação: uma origem https sem caminho, até 20. A entrevista não carrega em um frame em nenhum outro lugar.
  2. Crie o convite no seu servidor e passe o link dele para a página. A chave de API nunca vai para a página.
  3. Monte-a com TesteeEmbed.mount: um contêiner, o link e uma função onEvent. A aba Incorporação do painel mostra o snippet.
  4. Trate os eventos: ready, login_required, started, completed, feedback_submitted e error, cada um apenas com ids.

Como dispensar o código de login

Por padrão, o candidato entra dentro do frame com um código de 6 dígitos enviado por e-mail; a sua página nunca o vê. Se o seu site já autenticou o candidato, crie o convite pela API com skipSignIn, e só o link abre a entrevista. O painel não permite definir isso.

  • A contrapartida: o link passa a ser a única chave, então qualquer pessoa que o tenha pode fazer a entrevista. Mantenha a validade em um ou dois dias, crie o convite pouco antes de o candidato começar e mostre-o apenas atrás do seu próprio login.
  • No registro: o convite mostra "Login dispensado", e os resultados informam que a identidade foi verificada pelo site da sua empresa.

Teste antes de entrar em produção

Um teste completo

  1. Use um candidato de teste com um e-mail que você consiga ler; as prévias feitas por membros da equipe não enviam webhooks.
  2. Envie um evento de teste de webhook pelo menu do endpoint: um test.ping assinado, que também verifica o seu código de assinatura.
  3. Leia o log de entregas na página do endpoint. Reenviar envia uma entrega de novo com o mesmo id, o que testa se você ignora repetições.
  4. Mova o candidato para a etapa vinculada e confira a aba Atividade da conexão com o ATS: cada evento, convite e nota aparece como concluído, em nova tentativa, com falha ou ignorado.
  5. Faça a entrevista e confira se o results.ready chegou ou se a nota apareceu no ATS. As soluções para problemas comuns estão na documentação de solução de problemas do ATS.

Notas de segurança

  • As chaves ficam no servidor, uma por sistema, apenas com os escopos de que ele precisa, uma lista de IPs permitidos e uma validade. Revogue qualquer chave que você suspeite ter vazado.
  • Verifique antes de confiar: rejeite webhooks cuja assinatura ou timestamp falhe, e leia os dados pela API.
  • Autorize apenas os seus próprios sites para a incorporação.
  • Os links de convite são pessoais: nunca os registre em logs nem os compartilhe, principalmente com skipSignIn.

Notificações no Slack

Em Integrações → Slack, conecte com Adicionar ao Slack ou com um incoming webhook, escolha quais notificações publicar, como resultados prontos, e envie uma mensagem de teste (documentação do Slack).

Resumo

  • Se você usa um dos cinco ATSs compatíveis, use a conexão nativa: vincule cada vaga e etapa a uma entrevista publicada.
  • Caso contrário, use a API com chaves de escopo limitado e com validade, cabeçalhos Idempotency-Key, e verifique todos os webhooks.
  • Para manter os candidatos no seu site, adicione a incorporação e dispense o código de login apenas atrás do seu próprio login.
  • Antes de entrar em produção, faça um teste completo com um candidato fictício.

Perguntas e respostas

O testee se integra ao Greenhouse ou ao Workable?

Sim, de forma nativa, e também ao Teamtailor, Recruitee e Breezy HR. Você vincula uma vaga e uma etapa a uma entrevista publicada; cada candidato movido para essa etapa é convidado uma única vez, e os resultados voltam como uma nota.

Existe uma API de entrevista com IA?

Sim. A API REST cria candidatos e convites, informa o status deles e retorna resultados, relatórios em PDF e exportações em CSV. Webhooks assinados avisam o seu sistema quando algo acontece.

O meu ATS não é compatível. Ainda posso conectá-lo?

Sim, pela API: crie o convite quando o candidato chegar à etapa certa, guarde nele o seu externalId e busque os resultados quando chegar o results.ready.

Os candidatos podem fazer a entrevista na nossa página de carreiras?

Sim, com o SDK de incorporação: autorize o seu site em Integrações → Incorporação, crie o convite com a API e monte-o na sua página.

O resultado faz os candidatos avançarem no ATS?

Não. O testee nunca move nem rejeita um candidato. A nota traz a pontuação de cobertura, com o rótulo "para revisão, não uma decisão de contratação"; quem decide é uma pessoa.

O que deve constar em um checklist de integração com o ATS?

Quais vagas e etapas enviam convites, quem é responsável pelas chaves, como os webhooks são verificados, o que volta para o ATS, como as falhas são percebidas, como são tratados os candidatos da cidade de Nova York e os pedidos de adaptação, e um teste completo.

Fontes

  1. Documentação para desenvolvedores do testee: integrações com ATS
  2. Documentação para desenvolvedores do testee: API REST
  3. Documentação para desenvolvedores do testee: Webhooks
  4. Documentação para desenvolvedores do testee: SDK de incorporação
  5. Documentação para desenvolvedores do testee: Slack
  6. Especificação Standard Webhooks
  7. RFC 2104, HMAC: Keyed-Hashing for Message Authentication

Teste nasua próxima vaga.

Crie uma entrevista estruturada com IA a partir da sua descrição de vaga em minutos.14 dias grátis, sem cartão.