Integrações

Não troque de ATS. Encaixe a Aya no que você já usa.

A entrevista da Aya entra como uma etapa do processo que você já tem. O candidato conversa pelo WhatsApp, e a nota com a evidência volta para a ficha onde o seu time já olha — sem ninguém abrir uma segunda tela.

Chave de API, ambiente de testes e webhooks se resolvem sozinhos nas configurações da conta. Não existe fila de espera nem projeto de implantação para começar.

O argumento

Plug-and-play quer dizer isto, em três frases

Nenhuma migração, nenhuma ferramenta nova para o time aprender, nenhum relatório para montar à mão.

Etapa, não substituição

O seu ATS continua dono do processo

Vaga, pipeline e histórico ficam onde estão. A Talpy não pede que você migre nada nem que o recrutador troque a tela em que trabalha todo dia.

Entrevista

A Aya conversa com todo mundo que se candidatou

Entrevista por WhatsApp ou por link, no ritmo do candidato: ele responde quando dá, e ninguém marca horário. A triagem deixa de ser uma fila e passa a ser uma lista ordenada.

Retorno

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ê.

Integração nativa

Workable: ligue em quatro passos e a nota volta na ficha

É a única integração nativa hoje, e ela é de ida e volta: o Workable avisa quando o candidato chega na etapa que você escolheu, e a Talpy devolve a avaliação para a ficha dele lá.

01

Conecte

Subdomínio e um token de acesso gerado por um administrador do seu Workable. O token fica cifrado do nosso lado.

02

Escolha a etapa-gatilho

Candidato movido para essa etapa é importado com a vaga e o currículo, e já recebe uma nota de triagem antes da conversa. Deixando em branco, toda candidatura nova entra.

03

A Aya entrevista

O convite sai pelo WhatsApp do candidato. Quando falta telefone na ficha, escrevemos um comentário avisando em vez de falhar em silêncio.

04

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 você quiser, o aprovado também muda de etapa sozinho.

O que esta integração não faz

  • Uma conexã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 você definir, negativo abaixo dela. Ela nasce em 7.
  • A vaga espelhada na Talpy nasce interna e não vai para o Google. A vaga pública continua sendo 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 fora do ar na hora da avaliação, a nota fica registrada na Talpy e o erro aparece na tela da integração.

Guia passo a passo

Qualquer outro ATS

Webhooks assinados: o seu sistema fica sabendo na hora

Cada evento do candidato sai como um POST para o endereço que você cadastrar. 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.

  1. candidato.criado

    Alguém se candidatou — pelo link da vaga, pela página de carreiras ou pela API.

  2. candidato.triado

    O currículo foi lido e recebeu a nota de aderência ao perfil da vaga.

  3. entrevista.iniciada

    O candidato respondeu o primeiro contato e a conversa com a Aya começou.

  4. candidato.avaliado

    A Aya concluiu a entrevista e gravou a avaliação: nota, competências e evidência.

  5. candidato.decidido

    O RH aprovou ou reprovou o candidato — a decisão humana, registrada.

  6. revisao.solicitada

    O candidato pediu revisão humana da avaliação. Vale tratar com prioridade.

Assinado, para você poder confiar

Todo POST leva o HMAC-SHA256 do corpo, calculado com um segredo exclusivo do seu endpoint. Conferir a assinatura é o que impede alguém de fingir ser a 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 status HTTP que o seu servidor devolveu, ao lado da hora da última entrega real.

O que não existe

Reentrega automática. O endpoint que não responder em cinco segundos perde aquele evento; o status fica registrado na tela, e o caminho para recuperar o que passou é a API.

API pública

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.

GET/api/v1/jobsjobs:read
GET/api/v1/jobs/{id}jobs:read
POST/api/v1/jobsjobs:write
PATCH/api/v1/jobs/{id}jobs:write
GET/api/v1/jobs/{id}/candidatescandidates:read
POST/api/v1/candidatescandidates:write
GET/api/v1/candidates/{id}candidates:read
POST/api/v1/candidates/{id}/whatsappwhatsapp:send
GET/api/v1/interviews/{id}interviews:read
POST/api/mcpmcp:read

7 permissões, marcadas uma a uma

A chave nasce só com o que você marcar, e as permissões são separadas por AÇÃO porque o dano de cada uma é diferente: ler vaga é público de fato, 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
Cadastrar 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 para um candidato pelo WhatsApp.
mcp:read
Consultar a Talpy por um agente de IA usando o protocolo MCP.

A chave aparece uma vez só

Guardamos o hash, não a chave — nem nós conseguimos recuperá-la depois. Quem perder revoga e gera outra, e o prefixo do valor diz em voz alta, dentro do próprio segredo, se ele é de produção ou de teste.

Limite e ambiente em cada resposta

120 requisições por minuto por chave. Toda resposta diz quanto sobrou do limite e em que ambiente ela foi produzida — para você não descobrir o teto batendo nele, nem jurar que apontou para produção lendo dados de brinquedo.

Exemplos em curl e o formato de cada resposta

Ambiente de testes

Uma cópia da sua empresa, com gente que não existe

Chave de teste trabalha numa organização-espelho da sua, criada na hora e já semeada com uma vaga, dois candidatos em estágios diferentes e uma avaliação para ler.

Mesmas rotas, mesmos erros

Não é simulação com resposta falsa: é o mesmo código e o mesmo banco, só com dados de brinquedo. 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, então não existe para onde mandar mensagem.

Dá para zerar

Bagunçou o sandbox testando? Um comando apaga e semeia tudo de novo, e a sua operação real não sente nada.

Assistente de IA

Pergunte pelo assistente que a sua equipe já usa

A Talpy expõe um servidor MCP: o cliente de IA da empresa aponta para o endereço, manda a chave, e o time pergunta em linguagem natural — “quem foi melhor na vaga de atendente?”. Existe porque quem compra recrutamento é RH, não engenharia: a API pressupõe alguém que escreve código, lê documentação e trata erro.

Cinco consultas, e só consultas

listar_vagas
As vagas da empresa, com situação 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 etapa, 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 dado de nenhuma pessoa.

Três travas, e nenhuma é enfeite

  • Permissão própria. O acesso por assistente tem escopo 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 o dado dos candidatos dela pode ser lido por um modelo dentro do cliente de IA que ela escolheu.
  • Auditoria por consulta. Cada chamada entra na trilha de auditoria da empresa, com o que foi perguntado. Acesso a dado de candidato que não deixa rastro é o que não se consegue explicar depois.

Só leitura, e sem contato

Nenhuma ferramenta escreve, decide, exclui ou manda mensagem — um modelo interpretando “avisa todo mundo 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.

Sem programar

Zapier, Make, n8n, planilha, chat do time

Funciona pelo webhook — e aqui vai a parte sincera: não temos um app publicado 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 você cola o endereço que a Talpy gera.

De lá, candidato avaliado vira linha em planilha, card no seu quadro, mensagem no chat do time ou candidato criado no seu ATS. A receita pronta está na documentação, junto do formato do corpo que chega.

Ver a receita

Honestidade

O que ainda não existe

Esta página promete só o que está no produto hoje. O que falta, falta — e descobrir isso numa reunião custa o tempo de todo mundo.

  • App publicado nos diretórios do Zapier, do Make ou do n8n. A ligação é por webhook, e é você que a faz.
  • Integração nativa com Gupy, Greenhouse, Lever, SAP ou Workday. Esses entram pela API e pelos webhooks, não por um botão.
  • Reentrega automática 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 mão dupla fora do Workable. Em qualquer outro ATS, quem decide o que sobe e quando é o seu código.
Perguntas

O que perguntam antes de integrar

Preciso de desenvolvedor para começar?

Para o Workable, não: a ligação é feita numa tela, com um token do seu Workable. Para os webhooks, alguém precisa ter 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 candidato real?

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 uso?

120 requisições por minuto por chave, e a resposta sempre diz quanto sobrou. Se o seu caso precisar de mais, fale com a gente antes de construir em volta do teto.

Falar com a gente

Conte qual ATS você usa

Diga o sistema, o volume de vagas e em que ponto do processo a Aya deveria entrar. A gente responde com o caminho concreto — e quando não existe caminho, dizemos isso também.

Usamos estes dados só para responder você. Detalhes em Política de Privacidade.

IA explicável · decisão humana