API do BambooHR: colaboradores, ausências e relatórios com agentes de IA
A API do BambooHR permite ler e atualizar dados de colaboradores, consultar ausências, gerar relatórios e receber webhooks de mudanças. É usada por empresas que integram RH com folha, identidade e outras ferramentas. O acesso é por chave de API de um usuário ou por OAuth para parceiros.
Os grandes recursos da API, em português claro.
Ler e atualizar dados cadastrais e de cargo.
Saldos, solicitações e quem está fora.
Gerar relatórios personalizados.
Histórico de cargo, remuneração e outras tabelas, conforme permissão.
Documentos ligados ao colaborador.
Avisos quando dados de colaboradores mudam.
Como se acessa a API do BambooHR.
- Com credencial da sua empresaChave de API gerada no perfil de um usuário, usada em autenticação básica; o acesso segue as permissões desse usuário. Parceiros usam OAuth.
- Documentação oficialdocumentation.bamboohr.com
- A chave herda permissões do usuário: restrinja.
- Dados de RH são sensíveis: aplique a LGPD.
- Valide gravações antes de liberar.
- api bamboohr
- bamboohr api
- bamboohr api documentação
- integração bamboohr
- bamboohr webhook
- bamboohr api key
O que um agente do iTeam faz com a API do BambooHR.
O agente avisa as equipes no Slack quem está de férias ou ausente.
O colaborador pergunta o saldo e o agente responde só com os dados dele.
Na admissão, o agente cria tarefas e acessos nos outros sistemas, com aprovação.
O agente aponta cadastros com campos faltando e cobra o RH.
Da credencial ao agente trabalhando, com aprovação.
Usuário de integração
Crie um usuário com permissões mínimas e gere a chave de API.
Cofre e campos permitidos
Guarde no cofre do iTeam e limite campos sensíveis, como remuneração.
Teste com aprovação
Gravações de dados passam por aprovação humana.
Dúvidas sobre a API do BambooHR.
A API do BambooHR é gratuita?
A API faz parte do BambooHR para clientes, sem cobrança separada divulgada.
Preciso programar para usar a API do BambooHR com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação da API e aprende os endpoints, e o time de implantação configura credenciais, permissões e testes com você.
A API do BambooHR tem webhooks?
Sim, é possível configurar webhooks para avisar mudanças em campos de colaboradores.
Como gerar a chave de API do BambooHR e que permissões ela tem?
A chave é gerada no perfil de um usuário do BambooHR e vai em autenticação básica; o acesso espelha as permissões desse usuário. Crie um usuário próprio para a integração com o menor acesso possível, em vez de usar a conta de um administrador de RH.
O BambooHR permite OAuth ou só chave de API?
Os dois existem. A chave de API serve para a empresa conectar a própria conta, e o OAuth é o caminho dos parceiros que publicam integrações para vários clientes. Para uso interno de uma empresa, a chave de um usuário dedicado costuma bastar. Confira os detalhes em documentation.bamboohr.com.
Como o agente de IA usa os relatórios e tabelas do BambooHR?
A API expõe relatórios personalizados e tabelas, como histórico de cargos e salários, além de ausências. O agente pode puxar um relatório já montado no BambooHR e resumir para o gestor, por exemplo quem está de folga na semana, sem copiar planilhas na mão.
O que o webhook do BambooHR permite automatizar com um agente?
Webhooks avisam quando campos de colaboradores mudam. Assim o agente reage na hora a uma admissão ou mudança de cargo, sem consultar a API a cada minuto. Um uso típico é abrir a lista de tarefas de integração do novo colaborador no quadro do iTeam.
Quais dados de RH do BambooHR são mais sensíveis para o agente de IA?
Salário, dados de saúde ligados a ausências, documentos e identificação pessoal pedem cuidado, porque a LGPD trata vários deles como dados pessoais. Restrinja a chave aos campos necessários e defina quais perguntas o agente pode responder a cada perfil.
Posso deixar o agente escrever dados de colaboradores no BambooHR?
Pode, a API aceita atualização de colaboradores, mas a gravação deve ser validada antes de liberar. Comece com o agente propondo a alteração e um responsável de RH aprovando. No iTeam, a aprovação humana e a trilha de auditoria registram quem aprovou cada mudança.
O BambooHR tem ambiente de testes para validar a integração?
Não consegui confirmar um sandbox público do BambooHR; confira na documentação oficial se há conta de teste para o seu plano. Na dúvida, rode as primeiras leituras com a chave de um usuário de acesso restrito e só grave após revisar o resultado com o RH.
Quando não vale a pena ligar um agente ao BambooHR?
Se a empresa tem poucos colaboradores e quase nenhuma pergunta repetida ao RH, o ganho é pequeno. Também não vale se o cadastro no BambooHR está incompleto, pois o agente responderia com base em dados errados. Vale mais quando o RH responde sempre às mesmas dúvidas de ausência e cadastro.
