Como criar chaves de API para integrar sistemas
Crie chaves de API para cadastrar colaboradores na Volú a partir de outros sistemas, como o da folha.
As chaves de API permitem que outro sistema da empresa, como o de folha ou de RH, cadastre e atualize colaboradores na Volú automaticamente. Use quando quiser manter a Volú em dia com o seu sistema, sem importar planilhas.
Quem pode fazer isso
Somente o Owner pode criar e gerir chaves de API.
Criar uma chave
- 1No menu lateral, abra Configurações e clique em Integrações de API.
- 2Clique em Criar API Key.
- 3Dê um Nome da Key que identifique o sistema, como "Sistema de DP".
- 4Escolha o Rate Limit: quantas chamadas por minuto o sistema pode fazer.
- 5Clique em Criar.
- 6Copie a chave e guarde num lugar seguro.
A chave aparece uma única vez. Se perder, revogue e crie outra.
Usar a chave
Na aba Documentação estão o endereço, os cabeçalhos, o formato da requisição e um exemplo pronto para copiar. Passe essas informações para quem vai fazer a integração. Cada chamada cadastra ou atualiza até 100 colaboradores.
O cadastro feito pela API cria a pessoa na Volú. O acesso dela segue o login da empresa: com login corporativo (SSO), ela entra pelo e-mail de trabalho.
Acompanhar o uso
Na aba Logs, veja as últimas 100 chamadas feitas com as chaves, com a data, o resultado e a duração. Na lista de chaves, Último Uso mostra quando cada chave foi usada pela última vez.
Revogar ou excluir uma chave
- Revogar: a chave para de funcionar, mas continua na lista.
- Excluir: no menu da chave, apaga a chave de vez.
Revogue a chave sempre que suspeitar que ela foi exposta.
Dúvidas comuns
A chamada voltou com erro 401. A chave está errada, revogada ou expirada.
A chamada voltou com erro 429. O sistema passou do limite de chamadas por minuto da chave. Espere um pouco ou crie uma chave com limite maior.
A integração envia e-mail de boas-vindas? Não. A Volú não envia e-mail de boas-vindas pela API.
Conteúdo referente à versão 1.16.0 da Volú
Continue lendo
Ver tudo em Configurações & integraçõesComo importar dados por planilha CSV
Importe colaboradores, skills, papéis e histórico de uma vez, a partir de uma planilha CSV.
Como cadastrar e gerir as pessoas da empresa
Cadastre pessoas, defina área, papel, gestor e perfil de acesso, e inative quem saiu da empresa.
Entenda as configurações da plataforma
Veja o que fica em cada item do grupo Configurações e quem pode mexer em cada um.
