Usar o portal de carreiras da TAI

As vagas publicadas no módulo Recrutamento ficam disponíveis num portal de carreiras pronto, no subdomínio da empresa, com a logomarca dela e uma página por vaga com formulário de candidatura. Para ter uma página de vagas sem construir nada, basta configurar o subdomínio e apontar o seu site para lá.

Quando usar	O site da empresa só precisa de um botão “Trabalhe conosco”; anúncios e redes sociais precisam de link para cada vaga
Porta	Página pública · REST (configuração)
Você vai precisar	módulo CONTRATACOES; papel de titular da conta (CUSTOMER_OWNER) para configurar o subdomínio e a logomarca

Como funciona

titular ──► PUT /tenant/meu-subdominio   { "subdominioPortal": "suaempresa" }
                 │
                 ▼
     https://suaempresa.vagas.taitecnologia.com            lista das vagas publicadas
     https://suaempresa.vagas.taitecnologia.com/{urlPublica}  página da vaga + candidatura
                 │
                 ▼
     candidatura no pipeline da vaga · evento CANDIDATURA_CRIADA

Passo a passo

1. Defina o subdomínio. Na tela Contratações › Configurações › Portal de Vagas ou pela API, com o token do titular:

   PUT /tenant/meu-subdominio
   Authorization: Bearer <token do titular>
   Content-Type: application/json
   
   { "subdominioPortal": "suaempresa" }

   Regras: de 3 a 63 caracteres, letras minúsculas, números e hífen (sem começar nem terminar com hífen), único na TAI. Vale na hora. Consulte o atual com GET /tenant/meu-subdominio. O mesmo subdomínio é usado pela central de ajuda do atendimento.

2. Envie a logomarca. POST /tenant/minha-logomarca, multipart/form-data com o arquivo na parte logomarca (JPG, PNG, GIF, WEBP ou SVG, até 5 MB). DELETE /tenant/minha-logomarca remove.

3. Publique as vagas. Só vagas com status Publicada aparecem no portal. Ao publicar, a vaga ganha a urlPublica — veja Gerenciar vagas e etapas.

4. Ligue o seu site ao portal. No botão “Trabalhe conosco”, aponte para https://suaempresa.vagas.taitecnologia.com. Para anúncios e redes sociais, use o link de cada vaga: https://suaempresa.vagas.taitecnologia.com/{urlPublica} — é uma página pública indexável, com o formulário de candidatura.

Quando o portal não basta

Se o site precisa mostrar as vagas com o próprio layout — dentro da página, com filtros, no idioma e no estilo da marca —, use as mesmas rotas públicas que alimentam o portal:

Rota	O que faz
GET /public/portal-vagas/{subdominio}/empresa	Nome, subdomínio e logomarca da empresa
GET /public/portal-vagas/{subdominio}/vagas?search=&page=&size=&sort=	Vagas publicadas, paginadas
GET /public/portal-vagas/{subdominio}/vagas/count	Quantidade de vagas publicadas
GET /public/portal-vagas/{subdominio}/vagas/{urlPublica}	Uma vaga
POST /public/portal-vagas/{subdominio}/candidatar	Candidatura com currículo

O passo a passo, com o envio da candidatura e as validações, está em Publicar as vagas no seu site.

Nota

As rotas /carreiras/vagas listam as vagas publicadas de todas as empresas da TAI — é o agregador de vagas. Para a sua empresa, use sempre /public/portal-vagas/{subdominio}.

Automatize

Cada candidatura pelo portal publica Alguém se candidata a uma vaga (CANDIDATURA_CRIADA). Para recebê-la num webhook, avisar o time no Slack ou levar a candidatura a outro sistema, veja Candidaturas no seu sistema.

Cuidados

• Trocar o subdomínio muda todos os links. O endereço antigo deixa de responder e os links já divulgados (anúncios, redes sociais, página da central de ajuda) param de funcionar. Escolha o subdomínio antes de divulgar.
• Subdomínio já usado por outra empresa é recusado com 400.
• A configuração do subdomínio e da logomarca é do titular da conta; um usuário de integração comum recebe 403 nessas rotas.