API da Factorial: o que dá para fazer e como usar com agentes de IA
A API da Factorial dá acesso a dados de RH como colaboradores, equipes, ausências, controle de ponto e documentos. É usada por áreas de RH e integradores que ligam a Factorial à folha, a sistemas de acesso e à comunicação interna. O acesso é por OAuth 2.0 com aplicativo registrado ou chave de API da empresa.
Os grandes recursos da API, em português claro.
Cadastro, contratos e dados de emprego.
Times, locais de trabalho e gestores.
Solicitações, aprovações e saldos.
Registros de entrada e saída e turnos.
Arquivos dos colaboradores e da empresa.
Avisos de eventos como novos colaboradores e ausências.
Como se acessa a API do Factorial.
- Com credencial da sua empresaOAuth 2.0 com aplicativo registrado na conta da Factorial, ou chave de API gerada por um administrador. As permissões seguem o perfil autorizado.
- Documentação oficialapidoc.factorialhr.com
- Dados de colaboradores são pessoais e alguns sensíveis (LGPD).
- O colaborador só deve ver os próprios dados; o agente verifica a identidade.
- Respeite os limites de requisição da API.
- api factorial
- factorial hr api
- factorial api colaboradores
- factorial api ausências
- integração api factorial
- factorial api documentação
O que um agente do iTeam faz com a API do Factorial.
No Teams, o colaborador pergunta e o agente consulta o saldo na Factorial e responde, sem abrir chamado no RH.
O agente registra a solicitação de ausência e avisa o gestor para aprovar.
O agente identifica marcações faltando no período e lembra cada pessoa antes do fechamento.
Quando entra um colaborador, o agente prepara a lista de documentos e cria as tarefas do gestor e da TI.
Da credencial ao agente trabalhando, com aprovação.
Registre o aplicativo na Factorial
Um administrador cria o app ou a chave com escopos mínimos.
Cadastre no cofre do iTeam
A credencial fica no cofre e só os agentes de RH usam, com leitura separada de escrita.
Teste com aprovação
Registros de ausência e alterações de cadastro começam com aprovação do RH.
Dúvidas sobre a API do Factorial.
A API da Factorial é gratuita?
De forma geral, a API está disponível para clientes conforme o plano contratado; confirme com a Factorial.
Preciso programar para usar a API da Factorial com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação e o time de implantação configura os fluxos.
O agente aprova férias sozinho?
Não. Ele registra e encaminha; a aprovação continua com o gestor.
A Factorial autentica a API por OAuth ou por chave de API?
Aceita OAuth 2.0, com aplicativo registrado na conta, ou uma chave de API gerada por um administrador. As permissões seguem o perfil autorizado. Para uso interno de uma empresa, a chave costuma ser o caminho mais direto; apps para várias empresas usam OAuth.
Que dados de RH o agente de IA lê na Factorial?
Colaboradores, equipes e estrutura, ausências e férias, controle de ponto e documentos. Pode responder quanto de férias alguém tem ou quem está ausente, desde que o acesso ao dado seja permitido ao perfil de quem pergunta.
Como garantir que o colaborador veja só os próprios dados na Factorial?
O agente deve verificar a identidade de quem pergunta antes de responder e filtrar a consulta por essa pessoa. Dados de colaboradores são pessoais, e alguns sensíveis, segundo a LGPD; um colaborador não deve ver o saldo de outro.
O agente aprova férias sozinho na Factorial?
Não deve: a aprovação é decisão do gestor ou do RH. O agente confere o saldo, registra o pedido e avisa o aprovador, que decide dentro da Factorial. O resultado fica no registro de ausências da própria ferramenta.
A Factorial tem webhooks para eventos de RH?
Sim, a lista de recursos inclui webhooks para eventos de RH, que permitem ao agente reagir a, por exemplo, um pedido de ausência. Confirme em apidoc.factorialhr.com os eventos atuais e valide a origem da notificação antes de agir.
A Factorial tem sandbox para testar a integração?
Não confirmei um sandbox público. Confira com a Factorial se oferece conta de teste; sem ela, use dados de poucos colaboradores de teste e comece apenas com leitura, validando as respostas com o RH antes de expandir. Defina também quem valida as respostas do agente.
A API da Factorial limita requisições?
Há limites que o agente deve respeitar, esperando após erro de excesso. Os detalhes estão em apidoc.factorialhr.com. Busque dados por período e por equipe, em vez de ler todos os colaboradores a cada pergunta. Confirme os limites atuais antes de agendar rotinas.
Vale ligar IA à Factorial numa empresa pequena?
Vale quando o RH responde sempre as mesmas dúvidas de férias e ponto e perde tempo com isso. Em empresas com poucas pessoas, a própria ferramenta já basta, e o agente adicionaria mais complexidade do que alívio.
