Não mude de ATS. Encaixe a Aya no que já utiliza.
A entrevista da Aya entra como uma etapa do processo que já tem. O candidato conversa pelo WhatsApp, e a nota com a evidência volta para a ficha onde a sua equipa já olha — sem ninguém abrir um segundo ecrã.
Chave de API, ambiente de testes e webhooks resolvem-se sozinhos nas configurações da conta. Não há lista de espera nem projeto de implementação para começar.
Plug-and-play quer dizer isto, em três frases
Nenhuma migração, nenhuma ferramenta nova para a equipa aprender, nenhum relatório para montar à mão.
O seu ATS continua dono do processo
Vaga, pipeline e histórico ficam onde estão. A Talpy não pede que migre nada nem que o recrutador mude o ecrã em que trabalha todos os dias.
A Aya conversa com todos os que se candidataram
Entrevista por WhatsApp ou por link, ao ritmo do candidato: responde quando pode, e ninguém marca hora. A triagem deixa de ser uma fila e passa a ser uma lista ordenada.
A nota volta com a evidência que a sustenta
Nota geral, aderência ao perfil, nota por competência e o trecho literal da resposta que justifica cada uma. Quem decide é uma pessoa; a IA recomenda e mostra o porquê.
Workable: ligue em quatro passos e a nota volta à ficha
É a única integração nativa hoje, e é de ida e volta: o Workable avisa quando o candidato chega à etapa que escolheu, e a Talpy devolve a avaliação para a ficha dele lá.
Ligue
Subdomínio e um token de acesso gerado por um administrador do seu Workable. O token fica cifrado do nosso lado.
Escolha a etapa-gatilho
Candidato movido para essa etapa é importado com a vaga e o currículo, e recebe logo uma nota de triagem antes da conversa. Deixando em branco, entra toda a candidatura nova.
A Aya entrevista
O convite sai pelo WhatsApp do candidato. Quando falta telefone na ficha, escrevemos um comentário a avisar em vez de falhar em silêncio.
A nota volta
Comentário na ficha do Workable com nota, aderência, resumo, competências com evidência e link para a ficha completa, mais uma avaliação de polegar. Se quiser, o aprovado também muda de etapa sozinho.
O que esta integração não faz
- Uma ligação por empresa e uma etapa-gatilho. Dois fluxos diferentes na mesma conta ainda não cabem.
- A avaliação de polegar tem dois estados: positivo a partir da nota mínima que definir, negativo abaixo dela. Nasce em 7.
- A vaga espelhada na Talpy nasce interna e não vai para o Google. A vaga pública continua a ser a do Workable, e é assim que deve ser.
- Candidato que não veio do Workable não é empurrado para lá. Para esse caminho existem a API e os webhooks.
- Não há reenvio automático do retorno. Se o Workable estiver em baixo na hora da avaliação, a nota fica registada na Talpy e o erro aparece no ecrã da integração.
Webhooks assinados: o seu sistema fica a saber na hora
Cada evento do candidato sai como um POST para o endereço que registar. São seis, e cobrem o ciclo inteiro — não só o fim: um sistema que só recebe “avaliado” descobre a candidatura horas depois de ela existir.
candidato.criadoAlguém se candidatou — pelo link da vaga, pela página de carreiras ou pela API.
candidato.triadoO currículo foi lido e recebeu a nota de aderência ao perfil da vaga.
entrevista.iniciadaO candidato respondeu ao primeiro contacto e a conversa com a Aya começou.
candidato.avaliadoA Aya concluiu a entrevista e registou a avaliação: nota, competências e evidência.
candidato.decididoO RH aprovou ou recusou o candidato — a decisão humana, registada.
revisao.solicitadaO candidato pediu revisão humana da avaliação. Vale tratar com prioridade.
Assinado, para poder confiar
Todo o POST leva o HMAC-SHA256 do corpo, calculado com um segredo exclusivo do seu endpoint. Verificar a assinatura é o que impede alguém de se fazer passar pela Talpy e injetar um candidato aprovado no seu sistema.
X-Talpy-Signature: sha256=…
Teste antes de depender
Um botão no painel dispara um evento assinado de teste e mostra o estado HTTP que o seu servidor devolveu, ao lado da hora da última entrega real.
O que não existe
Reenvio automático. O endpoint que não responder em cinco segundos perde aquele evento; o estado fica registado no ecrã, e o caminho para recuperar o que passou é a API.
API v1: para quem prefere escrever o fluxo
REST com JSON, autenticada por chave e versionada no caminho. Os endpoints cobrem vaga, candidato, currículo, convite pelo WhatsApp e a entrevista com transcrição e avaliação.
/api/v1/jobsjobs:read/api/v1/jobs/{id}jobs:read/api/v1/jobsjobs:write/api/v1/jobs/{id}jobs:write/api/v1/jobs/{id}/candidatescandidates:read/api/v1/candidatescandidates:write/api/v1/candidates/{id}candidates:read/api/v1/candidates/{id}/whatsappwhatsapp:send/api/v1/interviews/{id}interviews:read/api/mcpmcp:read7 permissões, marcadas uma a uma
A chave nasce só com o que marcar, e as permissões são separadas por AÇÃO porque o dano de cada uma é diferente: ler vaga é público de facto, criar candidato mexe em dado pessoal, e enviar WhatsApp gasta dinheiro e arrisca a reputação do número da empresa.
jobs:read- Ler as vagas da empresa e os detalhes de cada uma.
jobs:write- Criar vagas e alterar vagas existentes.
candidates:read- Ler os candidatos de uma vaga e a ficha de um candidato.
candidates:write- Registar candidatos (inclusive com currículo em base64).
interviews:read- Ler a entrevista e a avaliação do candidato junto da ficha.
whatsapp:send- Enviar mensagem a um candidato pelo WhatsApp.
mcp:read- Consultar a Talpy através de um agente de IA usando o protocolo MCP.
A chave aparece uma só vez
Guardamos o hash, não a chave — nem nós conseguimos recuperá-la depois. Quem a perder revoga e gera outra, e o prefixo do valor diz em voz alta, dentro do próprio segredo, se é de produção ou de teste.
Limite e ambiente em cada resposta
120 pedidos por minuto por chave. Toda a resposta diz quanto sobrou do limite e em que ambiente foi produzida — para não descobrir o limite ao bater nele, nem jurar que apontou para produção a ler dados de brincar.
Uma cópia da sua empresa, com gente que não existe
A chave de teste trabalha numa organização-espelho da sua, criada na hora e já com uma vaga, dois candidatos em fases diferentes e uma avaliação para ler.
Mesmas rotas, mesmos erros
Não é simulação com resposta falsa: é o mesmo código e a mesma base de dados, só com dados de brincar. Resposta falsa mente sobre o formato e sobre os erros, e a diferença aparece em produção.
Nada sai para o mundo
Sem WhatsApp, sem cobrança e sem consumir o seu plano. Os candidatos de exemplo não têm telefone, por isso não há para onde enviar mensagem.
Dá para reiniciar
Desarrumou o sandbox a testar? Um comando apaga e volta a semear tudo, e a sua operação real não sente nada.
Pergunte pelo assistente que a sua equipa já usa
A Talpy expõe um servidor MCP: o cliente de IA da empresa aponta para o endereço, envia a chave, e a equipa pergunta em linguagem natural — “quem foi melhor na vaga de atendimento?”. Existe porque quem compra recrutamento é RH, não engenharia: a API pressupõe alguém que escreve código, lê documentação e trata erros.
Cinco consultas, e só consultas
listar_vagas- As vagas da empresa, com estado e quantos candidatos cada uma tem.
detalhar_vaga- Uma vaga com as competências que a Aya avalia e o peso de cada uma — é por esses critérios que as notas se formam.
listar_candidatos- Os candidatos de uma vaga com nota, aderência e fase, do maior para o menor.
detalhar_candidato- A avaliação completa de um candidato: nota por competência, a evidência de cada nota, pontos de atenção, destaques e a decisão humana, se já houver.
resumo_do_recrutamento- Os números gerais da empresa: vagas abertas, candidatos, entrevistas concluídas, nota média e uso do plano. Não contém dados de nenhuma pessoa.
Três travões, e nenhum é enfeite
- Permissão própria. O acesso por assistente tem âmbito separado dos de leitura. Uma chave de integração que já lia candidatos não ganha este canal de brinde.
- Consentimento da empresa. Nasce desligado. Quem liga é o administrador da conta — não nós, e não quem gerou a chave: é a empresa que decide se os dados dos candidatos dela podem ser lidos por um modelo dentro do cliente de IA que ela escolheu.
- Auditoria por consulta. Cada chamada entra no registo de auditoria da empresa, com o que foi perguntado. Acesso a dados de candidato que não deixa rasto é o que não se consegue explicar depois.
Só leitura, e sem contacto
Nenhuma ferramenta escreve, decide, elimina ou envia mensagem — um modelo a interpretar “avisa todos que a vaga fechou” não deve conseguir gastar dinheiro. E nenhuma devolve telefone, e-mail ou currículo: para falar com a pessoa, alguém abre a ficha no painel, onde o acesso é nominal e fica na auditoria.
Zapier, Make, n8n, folha de cálculo, chat da equipa
Funciona pelo webhook — e aqui vai a parte sincera: não temos uma app publicada nos diretórios do Zapier nem do Make. O que existe é mais simples do que parece: qualquer uma dessas ferramentas aceita um gatilho de webhook, e é nele que cola o endereço que a Talpy gera.
A partir de lá, candidato avaliado torna-se linha numa folha de cálculo, cartão no seu quadro, mensagem no chat da equipa ou candidato criado no seu ATS. A receita pronta está na documentação, junto do formato do corpo que chega.
O que ainda não existe
Esta página promete só o que está no produto hoje. O que falta, falta — e descobri-lo numa reunião custa o tempo de todos.
- App publicada nos diretórios do Zapier, do Make ou do n8n. A ligação é por webhook, e é feita por si.
- Integração nativa com Gupy, Greenhouse, Lever, SAP ou Workday. Esses entram pela API e pelos webhooks, não por um botão.
- Reenvio automático de webhook que falhou.
- Escrita pelo assistente de IA. O canal MCP é só de leitura, de propósito, e isso não está na fila para mudar.
- Sincronização de dois sentidos fora do Workable. Em qualquer outro ATS, quem decide o que sobe e quando é o seu código.
O que perguntam antes de integrar
Preciso de um programador para começar?
Para o Workable, não: a ligação faz-se num ecrã, com um token do seu Workable. Para os webhooks, alguém precisa de um endereço que receba um POST — o que uma ferramenta de automação resolve sem código. A API é o caminho de quem quer escrever o fluxo.
Quanto custa a integração?
Nada à parte. API, webhooks, ambiente de testes e o canal de assistente de IA estão no produto; o que se cobra é entrevista. Os limites de cada plano estão na página de preços.
Dá para testar sem tocar em candidatos reais?
Sim, e é o caminho recomendado. Uma chave de teste trabalha numa cópia da sua empresa, já semeada, onde nada sai para o mundo — nem WhatsApp, nem cobrança. Quando funcionar lá, troque a chave.
Qual é o limite de utilização?
120 pedidos por minuto por chave, e a resposta diz sempre quanto sobrou. Se o seu caso precisar de mais, fale connosco antes de construir em volta do limite.
Diga-nos que ATS utiliza
Diga o sistema, o volume de vagas e em que ponto do processo a Aya deveria entrar. Respondemos com o caminho concreto — e quando não há caminho, dizemos isso também.
Usamos estes dados apenas para lhe responder. Detalhes em Política de Privacidade.