Abrir contas para quem chega

Todo colaborador novo precisa de coisas que vivem fora da TAI: caixa de e-mail, conta na VPN e no ERP, crachá, notebook. Esta jornada faz a TAI avisar o seu sistema de acessos (ou o service desk de TI) no momento do cadastro, com o id da pessoa para ele buscar o resto.

Quando usar	O cadastro de pessoas acontece na TAI (pela tela, por planilha ou pela admissão) e a TI precisa agir
Porta	Webhook · REST
Você vai precisar	Acesso a Processos › Central de Automações (dono da conta ou administrador); um endpoint HTTPS no seu sistema; um usuário de integração com leitura de COLABORADOR para buscar o cadastro

Como funciona

colaborador cadastrado na TAI ──► evento COLABORADOR_CRIADO
        │
        ▼
webhook assinando o evento ──► POST assinado no seu sistema
        │
        ▼
seu sistema ──► GET /colaborador/{id} ──► cria e-mail, contas, crachá

O evento Um colaborador é cadastrado sai em todo cadastro, venha de onde vier: a tela, a API, a importação por planilha, a conclusão de uma admissão ou a contratação de um candidato.

Passo a passo

1. Crie o webhook. Em Processos › Central de Automações, aba Webhooks, Novo webhook, com o endereço do seu sistema de acessos. Em O que enviar, marque Um colaborador é cadastrado (COLABORADOR_CRIADO). Marque Enviar também o registro completo se preferir receber a ficha inteira em vez de buscá-la no passo 3. O passo a passo da tela está em Assinar eventos.

2. Guarde o segredo, teste e ligue. O segredo aparece uma vez só; com ele o seu sistema confere a assinatura. A cada cadastro chega:

   {
     "id": "evt_51877",
     "tipo": "COLABORADOR_CRIADO",
     "descricao": "Um colaborador é cadastrado",
     "versao": 1,
     "ocorridoEm": "2026-10-06T12:04:51.233Z",
     "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
     "dados": {
       "colaboradorId": 1043,
       "colaboradorNome": "Ana Ribeiro",
       "gestorId": 1544
     }
   }

3. No seu sistema, busque o cadastro completo com o id recebido (ou leia o registro, se marcou o registro completo):

   GET /colaborador/1043
   Authorization: Bearer <token do usuário de integração>

   Dali saem o emailCorporativo (ou emailPessoal), o cargo, o departamento, a empresa, o codigoFuncionario e a dataAdmissao — o que o seu sistema precisa para decidir quais contas abrir.

4. Responda 2xx assim que receber e abra as contas numa fila sua. Se o seu sistema estiver fora, a TAI tenta de novo por cerca de 21 horas.

Mandar para o service desk ou para o Slack

Se o destino espera outro formato — um chamado no service desk de TI, uma mensagem num canal —, use um fluxo automatizado (Processos › Fluxos › Novo processo › Fluxo automatizado) que começa por Quando algo acontece com o evento Um colaborador é cadastrado e segue para o bloco Chamar outro sistema. O Corpo (JSON) usa os dados do evento:

{ "text": "Novo colaborador: {{gatilho.colaboradorNome}} (id {{gatilho.colaboradorId}}). Abrir e-mail e acessos." }

Quando cada pedido de acesso precisa de dono e prazo, deixe que um fluxo ouça o evento — veja Da TAI para o seu sistema.

O que a TAI já faz sozinha

No mesmo cadastro, sem integração nenhuma:

• Matrícula automática nos cursos das regras da empresa, por departamento e cargo (rotina lms-regras-matricula, começa ligada) — veja Desenvolvimento.
• Primeiro período aquisitivo de férias, quando o Guardião de férias está ligado — veja Férias e ausências.
• Usuário de acesso à TAI com o e-mail do cadastro. No cadastro pela API, o e-mail de boas-vindas sai quando enviarEmail não é false.

Admissão concluída ou colaborador cadastrado?

Quando a pessoa entra por uma admissão, saem dois eventos: Admissão concluída e Colaborador cadastrado. Para abrir contas, ouça só Colaborador cadastrado — ele cobre todas as origens. Use Admissão concluída quando o que interessa é a admissão em si; o modelo pronto “Onboarding de quem foi admitido” usa esse evento — veja Admissão.

Pelo seu agente de IA

“Quem foi cadastrado esta semana?” é uma leitura que o agente conectado por MCP responde. Abrir as contas no seu sistema continua sendo trabalho da sua integração.

Cuidados

• Processe uma vez só. A mesma entrega pode chegar mais de uma vez: guarde o X-Tai-Entrega e use o colaboradorId como chave.
• Concilie como rede. As novas tentativas cobrem quedas de horas. De tempos em tempos, leia GET /colaborador/page?sort=id,desc e pare no primeiro id que o seu sistema já conhece — veja a reconciliação.
• gestorId pode vir vazio quando a pessoa ainda não está numa unidade com responsável — veja Estrutura organizacional.
• Cadastro em lote gera um evento por pessoa. Uma importação de 300 colaboradores dispara 300 envios: o seu endpoint precisa aguentar a rajada e responder rápido.