Convidar para a admissão

Na admissão por convite, a pessoa contratada recebe por e-mail um link para o portal de admissão, onde preenche os dados cadastrais e envia os documentos. O RH acompanha tudo na plataforma e, ao final, efetiva o colaborador. Para convidar basta nome e e-mail — a pessoa não precisa existir na TAI, nem como candidato nem como colaborador.


Quando usar	A contratação foi decidida fora do Recrutamento da TAI (outro ATS, planilha, indicação)
Porta	REST · Página pública (portal da pessoa)
Você vai precisar	módulo `CONTRATACOES`; permissão `ADMISSAO` (edição); JWT de um usuário de integração

Como funciona

seu sistema ──► POST /admissao/processo/iniciar-por-convite   (um ou vários)
                    │  um processo e um link por pessoa; e-mail enviado
                    ▼
        pessoa abre https://app.taitecnologia.com/admissao/{token}
          passo 1: dados pessoais, endereço, documentos · passo 2: arquivos
                    │
                    ▼
        RH confere e finaliza ──► colaborador criado

Passo a passo

Prévia sem enviar. Valide o lote com ?simular=true: nada é gravado e nenhum e-mail sai.

curl -X POST "https://api.taitecnologia.com/admissao/processo/iniciar-por-convite?simular=true" \
  -H "Authorization: Bearer $TAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "convites": [
      { "nome": "Bruno Lima", "email": "bruno.lima@gmail.com" },
      { "nome": "Carla Souza", "email": "carla.souza@gmail.com" }
    ],
    "dataAdmissaoPrevista": "2026-11-03",
    "tipoContrato": "CLT"
  }'

A resposta tem o mesmo formato da execução, com "simulacao": true.

Envie de verdade. Repita a chamada sem simular. Para um único convite, nome e email podem ir na raiz do corpo. Também são aceitos responsavelId, observacoes, documentosCustomizados e modeloChecklistId.

A resposta separa o que deu certo do que não deu — um e-mail inválido não derruba o lote:
```
{
  "simulacao": false,
  "totalSucesso": 1,
  "totalErro": 1,
  "sucessos": [ { "id": 311, "nomePessoa": "Bruno Lima", "status": "AGUARDANDO_DOCUMENTOS", "linkPortal": "https://app.taitecnologia.com/admissao/…" } ],
  "erros": [ { "nome": "Carla Souza", "email": "carla.souza@gmail.com", "motivo": "…" } ]
}
```
Guarde o id de cada processo ao lado do registro no seu sistema: é a chave para acompanhar e finalizar.
Acompanhe e finalize. Quando o processo chegar a APROVADO, finalize com POST /admissao/processo/{id}/finalizar-e-converter — o mesmo passo descrito em Do candidato ao colaborador. No convite, a aba de vínculo não vem de vaga nenhuma: informe empresaId, departamentoId, cargoId no corpo.

Documentos pedidos

O tipoContrato do convite vale para o lote todo e escolhe o modelo de documentos daquele vínculo (estagiário não recebe pedido de CTPS do CLT, por exemplo). Sem tipoContrato, vale o modelo padrão. Para forçar um modelo, use modeloChecklistId; para trocar a lista só neste convite, documentosCustomizados. Os modelos ficam em /admissao/checklist-modelo.

Muitos convites: planilha

curl -X POST "https://api.taitecnologia.com/admissao/processo/iniciar-por-convite/planilha?dataAdmissaoPrevista=2026-11-03&simular=true" \
  -H "Authorization: Bearer $TAI_TOKEN" \
  -F "arquivo=@convites.xlsx"

O .xlsx tem as colunas Nome e E-mail — baixe o modelo em GET /admissao/processo/iniciar-por-convite/modelo. A planilha é lida no servidor e cada linha segue as mesmas regras do JSON; a resposta tem o mesmo formato. Também aceita responsavelId e observacoes na query.

Link e validade

O link tem a forma https://app.taitecnologia.com/admissao/{token} e vale, por padrão, 30 dias (configurável em /admissao/configuracao, campo diasExpiracaoLink). Para gerar um link novo e reenviar o e-mail:

POST /admissao/processo/{id}/renovar-token

O link anterior deixa de funcionar na hora.

Portal da pessoa contratada

O portal é público, autenticado pelo token do link. Se você constrói uma experiência própria de admissão, as rotas são:

Rota	O que faz
`GET /admissao/portal/validar/{token}`	Diz se o link é válido (`valido`, `expirado`, `status`) ou, se não for, por quê (`mensagem`)
`GET /admissao/portal/{token}`	Dados do processo, documentos pedidos e situação de cada um
`GET` / `POST /admissao/portal/{token}/dados`	Lê e grava os dados cadastrais
`POST /admissao/portal/{token}/upload/{documentoId}`	Envia um documento (`multipart`, campo `arquivo`)
`GET /admissao/portal/{token}/documento/{documentoId}/arquivo`	Baixa um documento já enviado

Os dados e os arquivos são aceitos enquanto o processo está em AGUARDANDO_DOCUMENTOS ou PENDENTE_CORRECAO e o link não venceu. Nos dados, cpf e dataNascimento são obrigatórios, e um CPF que já é de um colaborador da conta é recusado. Um documento só é reenviado quando está pendente ou foi rejeitado. Arquivos aceitos: PDF, DOC, DOCX, JPG, JPEG, PNG, GIF, BMP e WEBP, até 50 MB.

Automatize

A rotina Cobrança de documentos da admissão (começa desligada) lembra quem está devendo e expira os links vencidos — veja Onboarding automático.
Para o sistema que disparou os convites acompanhar cada pessoa sem consultar a API, assine num webhook os eventos da admissão: Uma admissão começa (ADMISSAO_INICIADA, com origem CONVITE), A pessoa envia um documento da admissão (ADMISSAO_DOCUMENTO_ENVIADO), O prazo de uma admissão vence (ADMISSAO_EXPIRADA), Uma admissão é cancelada (ADMISSAO_CANCELADA) e Uma admissão é concluída (ADMISSAO_CONCLUIDA). Todos trazem o processoId que você guardou no passo 2:
```
{
  "id": "evt_55021",
  "tipo": "ADMISSAO_INICIADA",
  "descricao": "Uma admissão começa",
  "versao": 1,
  "ocorridoEm": "2026-10-06T13:30:12.447Z",
  "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
  "dados": {
    "processoId": 311,
    "nomePessoa": "Bruno Lima",
    "origem": "CONVITE",
    "dataAdmissaoPrevista": "2026-11-03"
  }
}
```
No convite ainda não há colaborador, candidatura nem vaga: colaboradorId, candidaturaId e vagaId não vêm preenchidos. A lista completa está no guia de Admissão.

Pelo seu agente de IA

Consultar convites e processos é leitura livre. Disparar convites não é executado pelo MCP: como envia e-mail a pessoas de fora da empresa, a operação é de confirmação forte e fica com a tela ou com a Tali, que mostra a lista de convidados antes de enviar.

Cuidados

Cada linha é recusada, com o motivo em erros, quando:

falta nome ou e-mail, ou o e-mail é inválido;
o mesmo e-mail aparece duas vezes no lote;
já existe um processo em andamento para aquele e-mail — renove o link dele em vez de criar outro;
já existe um colaborador ativo com aquele e-mail pessoal — use POST /admissao/processo/iniciar com o colaboradorId.

Reenviar o mesmo lote não duplica quem ainda está com o processo em andamento (AGUARDANDO_DOCUMENTOS, EM_ANALISE, PENDENTE_CORRECAO): essas linhas voltam em erros, sem segundo e-mail. Um processo já APROVADO e ainda não finalizado não conta como em andamento — confira pelo id guardado antes de reenviar. Datas civis em yyyy-MM-dd — veja Datas e formatos.

Referência gerada do contrato da API em 30 de outubro de 2026. taitecnologia.com · Termos de uso · Privacidade