API da Deel: o que dá para fazer e como usar com agentes de IA
A API da Deel dá acesso a contratos, pessoas, faturas, pagamentos, ajustes e folgas de contratados e funcionários em vários países. É usada por empresas que contratam pessoas no exterior ou têm times distribuídos. O acesso é por token de API da organização ou app OAuth.
Os grandes recursos da API, em português claro.
Consulta e criação de contratos de contratados e funcionários.
Dados de quem trabalha pela Deel na organização.
Faturas de contratados e histórico de pagamentos.
Inclusão de bônus, reembolsos e ajustes.
Pedidos e saldos de folga.
Eventos de contrato assinado, fatura emitida e outros.
Como se acessa a API do Deel.
- Com credencial da sua empresaUsa token de API gerado pelo administrador na Deel, com escopos escolhidos, ou OAuth 2.0 para apps; há ambiente de sandbox.
- Documentação oficialdeveloper.deel.com
- Pagamentos e ajustes exigem aprovação e teto.
- Dados de pessoas são pessoais e, em vários países, protegidos por leis locais.
- Use o sandbox antes de produção.
- api deel
- deel api
- deel api token
- api da deel contratos
- deel sandbox
- integração deel api
O que um agente do iTeam faz com a API do Deel.
Quando o contrato é assinado, o agente cria acessos, avisa o gestor e envia o kit de boas-vindas.
O agente lê o comprovante enviado, monta o ajuste de despesa e inclui na Deel após aprovação do gestor.
O agente reúne faturas e pagamentos para conciliação no financeiro.
O colaborador pergunta o saldo de folgas e o agente responde consultando a Deel.
Da credencial ao agente trabalhando, com aprovação.
Gerar o token com escopos
Na Deel, crie o token com os escopos necessários e teste no sandbox.
Guardar no cofre do iTeam
Cadastre o token e separe agentes de consulta de agentes que incluem ajustes.
Aprovar valores
Ajustes e despesas com valor só entram após aprovação do responsável.
Dúvidas sobre a API do Deel.
A API da Deel é gratuita?
A API não tem custo separado; o que se paga são os serviços da Deel contratados para cada pessoa.
Preciso programar para usar a API da Deel com o iTeam?
Não necessariamente. O time de implantação do iTeam configura a integração a partir da documentação da Deel.
O agente pode criar contratos?
Pode preparar, mas o recomendado é que a criação e o envio passem por aprovação do RH e do jurídico.
Como criar o sandbox da Deel para testar a API?
No Developer Center da Deel, na aba de sandbox, crie o ambiente definindo e-mail e senha; ele tem endereço e token próprios. Ali o agente testa contratos e pagamentos sem afetar a conta real, e dá para redefinir os dados de teste quando quiser recomeçar.
Token de API ou OAuth na Deel: qual escolher para o agente?
Para acessar os dados da própria organização, o token de API com escopos escolhidos. O OAuth 2.0 é para apps que atendem várias organizações. Um token de sandbox não vale em produção e vice-versa, o que evita misturar teste com dado real.
O agente pode criar contratos na Deel?
A API da Deel lida com contratos, mas criar um contrato tem implicações legais e de custo, então só com aprovação de RH e jurídico. O agente pode preparar os dados do contratado e deixar a criação para uma pessoa com alçada.
Como limitar pagamentos e ajustes feitos pelo agente na Deel?
Pagamentos e ajustes exigem aprovação e teto de valor. Dê ao token apenas os escopos necessários e coloque a confirmação humana em qualquer movimentação financeira. No iTeam, o agente também tem teto de gasto de IA, mas o teto de pagamentos é da Deel e da sua política.
O que o agente consulta na Deel no dia a dia?
Contratos, pessoas, faturas e pagamentos, ajustes e despesas, e folgas. Pode responder ao gestor quem está de folga, ou listar as faturas pendentes de contratados para o financeiro revisar e aprovar no ritmo do fechamento. Quem decide continua sendo o time de RH.
Os dados da Deel têm proteção legal em cada país?
São dados pessoais e, em vários países, protegidos por leis locais. Defina com o jurídico o que o agente pode ver de contratados de cada país e restrinja o acesso, em vez de dar visão global a quem só atende um país.
Os webhooks da Deel avisam o agente de eventos?
Sim, a API tem webhooks para eventos da plataforma, como contratos e pagamentos, e o agente reage a eles. Confira em developer.deel.com a lista de eventos e valide a origem do aviso antes de agir sobre ele.
Quando não vale integrar a Deel a um agente de IA?
Com poucos contratados e rotina simples, a conferência manual basta. Vale quando há muitos contratos em vários países e o financeiro cruza informações à mão entre a Deel e o sistema interno todo mês. Para pouca gente, a planilha dá conta.
