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.
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 ATS | API pública e webhooks | SDK de incorporação (com a API) | |
|---|---|---|---|
| Ideal para | Equipes que usam um dos cinco ATSs compatíveis | Qualquer outro ATS ou o seu próprio fluxo | Uma página de carreiras ou um portal que você controla |
| Código necessário | Nenhum | Chamadas à API e um receptor de webhooks | Algumas linhas na página, mais a API |
| O que envia o convite | Mover um candidato para a etapa vinculada | A sua chamada à API | A sua chamada à API; o link é montado na sua página |
| Os resultados voltam como | Uma nota no candidato dentro do ATS | Resultados que você busca após o webhook de resultados | O 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
- Publique a entrevista. Só uma entrevista publicada pode ser vinculada a uma vaga.
- 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.
- 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.
- 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.
- 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.


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.


Convide um candidato a partir do seu sistema
- GET /v1/interviews lista suas entrevistas publicadas.
- POST /v1/candidates com o nome e o e-mail. Um segundo candidato com o mesmo e-mail é recusado, então guarde o id.
- 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.
- 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 convite | O que faz |
|---|---|
| externalId | O seu próprio id (o da candidatura, por exemplo). Ele volta no convite e em todo webhook |
| returnUrl | Ao terminar, o candidato vê um botão para voltar a este endereço https (não dentro da incorporação) |
| extraTime | 25, 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 |
| nycNotice | O candidato mora na cidade de Nova York: o e-mail leva o seu aviso, e a entrevista abre 10 dias úteis depois |
| skipSignIn | O 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
- 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.
- 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.
- Monte-a com TesteeEmbed.mount: um contêiner, o link e uma função onEvent. A aba Incorporação do painel mostra o snippet.
- 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
- 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.
- 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.
- 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.
- 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.
- 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
- Documentação para desenvolvedores do testee: integrações com ATS
- Documentação para desenvolvedores do testee: API REST
- Documentação para desenvolvedores do testee: Webhooks
- Documentação para desenvolvedores do testee: SDK de incorporação
- Documentação para desenvolvedores do testee: Slack
- Especificação Standard Webhooks
- RFC 2104, HMAC: Keyed-Hashing for Message Authentication