# Freshbooks Automatize o provisionamento de usuários do FreshBooks e assegure dados atualizados dos colaboradores. Folha de pagamento · Provisionamento de identidade ![Freshbooks](https://www.manageengine.com/active-directory-360/marketplace/admanager-plus/images/marketplace-frsehbooks-logo-24.png) ## Visão geral O FreshBooks é um software de contabilidade popular baseado em nuvem, desenvolvido para pequenas empresas e freelancers, que oferece recursos de faturamento, controle de despesas, controle de tempo e relatórios. Ao integrar o FreshBooks ao ADManager Plus, as organizações podem simplificar e automatizar os processos de gerenciamento de usuários relacionados às suas contas FreshBooks. Essa integração garante que os dados dos usuários sejam mantidos consistentes e atualizados, reduzindo o esforço manual e minimizando erros. ### Criação automática de usuário Crie contas do FreshBooks automaticamente para novos colaboradores durante o processo de integração. Isso garante que os novos contratados possam acessar o FreshBooks imediatamente para gerenciar suas tarefas, como relatórios de despesas e acompanhamento de tempo. ### Atualização de dados do usuário Mantenha as informações do usuário do FreshBooks sincronizadas com os detalhes armazenados no Active Directory. Quando os dados de um colaborador (ex.: departamento, função ou informações de contato) são atualizados no AD, a integração garante que essas mudanças sejam refletidas na conta do FreshBooks. ## Configuração ### Documento de configuração: Integração do Freshbooks com o ADManager Plus **Pré-requisitos:** O Freshbooks usa o OAuth 2.0 para autorizar solicitações de API. Requer [client_id e client_secret](https://www.freshbooks.com/api/start?srsltid=AfmBOopU1BzuhNdNLUj0RFL2J9xh9Z_BQ0pZ1MKTiufjDHfj0QbeBBqW) para autorização. **Privilégios:** Importar usuários (ação de entrada): A conta utilizada na autorização deve ter permissão para ler todas as contas de usuário. Para executar qualquer ação ou consulta no Freshbooks (ação de saída): A conta usada deve ter permissão para realizar a ação desejada. **Nota:** O ADManager Plus é disponibilizado com um conjunto pré-configurado de APIs que auxiliam na execução de ações básicas com a integração. Se a ação que você precisa não estiver disponível, consulte a referência de API do Freshbooks para obter os detalhes de API necessários para a configuração de webhooks de entrada e saída para executar as ações requeridas. ### Configuração de autorização - LogFaça login no ADManager Plus e acesse **Directory/Application Settings**. - Selecione **Application Integrations**. - Em Enterprise Applications, pesquise em clique em **Freshbooks.** - Ative o botão **Enable Freshbooks Integration**. - Na página *Freshbooks Configuration*, clique em **Authorization**. - Execute as [etapas para gerar um client_id e um client_secret do Freshbooks](https://www.freshbooks.com/api/start?srsltid=AfmBOopU1BzuhNdNLUj0RFL2J9xh9Z_BQ0pZ1MKTiufjDHfj0QbeBBqW), e cole-os nos respectivos campos de valor. - Clique em **Configure**. ![Authorization](https://www.manageengine.com/active-directory-360/marketplace/admanager-plus/images/frsehbooks-ss1.png) ### Configuração de webhook de entrada Os webhooks de entrada permitem que você obtenha dados do usuário diretamente do Freshbooks e os envie para o ADManager Plus. O mapeamento de atributos definido aqui poderá ser selecionado como fonte de dados ao [configurar automatizações](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html). Para configurar um webhook de entrada para o Freshbooks: 1. Em *Inbound Webhook*, clique em **Freshbooks Endpoint Configuration**. 2. Na guia Endpoint Configuration, você encontrará um endpoint pré-configurado, o ENDPOINT DE USUÁRIOS do Freshbooks, com campos para a URL do endpoint, Método de API, Cabeçalhos e Parâmetros para obter contas de usuário do Freshbooks. Se você desejar usar esse endpoint pré-configurado, {business_id} pelo business ID de sua conta FreshBooks no campo Endpoint URL. No entanto, se você desejar usar um novo endpoint para importar usuários, você poderá configurar um usando o botão + Add API endpoint e preenchendo os campos obrigatórios de acordo com as [referências de API do Freshbooks](https://www.freshbooks.com/api/start?srsltid=AfmBOopU1BzuhNdNLUj0RFL2J9xh9Z_BQ0pZ1MKTiufjDHfj0QbeBBqW). Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como. **Nota:** - O par chave-valor da API já vem pré-configurado como cabeçalho para autenticar as solicitações de API, conforme definido durante a **configuração de autorização**. - Macros: É possível adicionar macros na configuração do endpoint para alterá-lo dinamicamente por meio do componente de seleção de macros. - Consulte as [referências de API do Freshbooks](https://www.freshbooks.com/api/start?srsltid=AfmBOopU1BzuhNdNLUj0RFL2J9xh9Z_BQ0pZ1MKTiufjDHfj0QbeBBqW) e configure cabeçalhos e parâmetros adicionais, se necessário. Na guia **Settings**, a opção **Repeat calling this endpoint** será configurada para buscar 30 registros por chamada. Isso será repetido até que nenhum token de próxima página seja recebido. ![Authorization](https://www.manageengine.com/active-directory-360/marketplace/admanager-plus/images/frsehbooks-ss2.png) 3. Após concluir, clique em **Test & Save**. A janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos pela chamada da API. Após verificar se os parâmetros desejados foram retornados, clique em **Proceed**. ![Authorization](https://www.manageengine.com/active-directory-360/marketplace/admanager-plus/images/frsehbooks-ss3.png) **Nota:** - Consulte as [referências de API do Freshbooks](https://www.freshbooks.com/api/start?srsltid=AfmBOopU1BzuhNdNLUj0RFL2J9xh9Z_BQ0pZ1MKTiufjDHfj0QbeBBqW) para saber os parâmetros que devem ser configurados para obter apenas parâmetros específicos. - Você pode configurar diversos endpoints para o Freshbooks usando o botão **+ Add API endpoint**. Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como. 4. Clique em **Data Source - LDAP Attribute Mapping** para vincular endpoints e mapear atributos LDAP do AD aos respectivos atributos no Freshbooks. 5. Clique em **+ Add New Configuration** e faça as seguintes ações: - Insira o *Nome da configuração* e a *Descrição*, e selecione a **Categoria de automação** no menu suspenso. - No campo *Select Endpoint*, escolha o endpoint desejado e defina uma *Chave primária* única para o usuário (por exemplo, employeeIdentifier). **Nota:** Quando vários endpoints estiverem configurados, essa chave deve manter o mesmo valor em todos eles. 6. No campo *Attribute Mapping*, selecione o atributo **LDAP Attribute Name** no menu suspenso e associe-o ao respectivo atributo no Freshbooks. 7. Se você quiser criar um novo formato personalizado para isso, clique em **Add New Format**. 8. Clique em **Save**.