Guias de integração

Cada módulo da TAI tem um guia com as jornadas que costumam ser integradas a ele: levar colaboradores do ERP para a TAI, publicar vagas no seu site, mandar o ponto fechado para a folha de outro sistema, avisar o financeiro quando a folha é aprovada. Cada jornada mostra o cenário, as chamadas exatas, o que a TAI já faz sozinha e como ligar a automação que fecha o ciclo.

As quatro portas

Toda jornada usa uma ou mais destas portas:

Porta	Direção	Quando usar
API REST	Seu sistema → TAI	Criar, atualizar e ler dados a partir de outro sistema. Autentica com o token JWT de um usuário de integração
Páginas públicas	Pessoas sem login → TAI	Candidatura, formulário, chamado pelo site, ponto no tablet. Sem token de usuário
Webhooks e automações	TAI ⇄ seu sistema	A TAI envia os eventos que você assinar, assinados e com novas tentativas; o seu sistema avisa a TAI por um endereço de entrada — veja Da TAI para o seu sistema
Agente de IA (MCP)	Agente → TAI	Um agente (Claude, ChatGPT) consulta e opera a TAI em conversa, com as mesmas permissões do usuário — veja MCP

Guias por módulo

Pessoas e departamento pessoal

Pessoas Colaboradores, estrutura organizacional, movimentações e desligamento.

Férias e ausências Solicitação, aprovação e programação de férias.

Admissão Convite, coleta de documentos e onboarding automático.

Ponto eletrônico Quiosque, comprovantes e o ponto fechado para a folha.

Folha de pagamento Lançamentos variáveis, ciclo da competência, eSocial e contabilização.

Talentos e desenvolvimento

Recrutamento Vagas no seu site, portal de carreiras e candidaturas no seu sistema.

Desenvolvimento e desempenho Treinamentos, metas, ciclos de avaliação e feedback.

Pesquisas Clima, formulários e diagnósticos comportamentais.

Operação

Processos (BPM) Abrir cards de outro sistema, aprovações e webhooks de fase.

Atendimento Widget no site, chamados de outros sistemas e escalonamento.

Documentos (GED) Envio, versões, aprovação e assinatura.

Financeiro Contas do seu ERP, baixas, cobrança e escritório contábil.

Tarefas, projetos e patrimônio Tarefas, apontamento de horas e inventário.

Antes de começar

Crie um usuário de integração

As chamadas REST de sistema devem usar um usuário dedicado à integração, com um perfil de acesso que só tenha os módulos e as permissões que a jornada precisa. Assim a integração não depende da senha de ninguém e não enxerga mais do que deve. Veja Empresa e permissões.

• Primeira chamada em 5 minutos — obter o token e chamar a API.
• Padrão das rotas — paginação, PATCH, referências por id.
• Datas e formatos e Limites — os dois motivos mais comuns de uma integração funcionar no teste e falhar em produção.