# Workable

![Workable](https://www.manageengine.com/active-directory-360/marketplace/images/logos/marketplace-workable-logo-24.png)

## Otimize a contratação e o onboarding com a integração Workable-AD

Provisionamento de identidade

O Workable é uma solução popular de software de recrutamento que ajuda empresas a otimizar seus processos de contratação, desde a publicação de vagas e a busca de candidatos até o acompanhamento e a avaliação de candidatos. Desenvolvido para organizações de todos os portes, o Workable oferece uma variedade de recursos, incluindo um sistema de acompanhamento de candidatos (ATS), ferramentas de contratação colaborativas e recomendações baseadas em IA, facilitando o gerenciamento eficiente do recrutamento. A integração do Workable com o ADManager Plus permite que as equipes de TI automatizem o provisionamento de usuários e mantenham os dados dos colaboradores atualizados no Active Directory (AD), Exchange, Microsoft 365 e outras aplicações corporativas. Em última análise, essa integração ajuda a preencher a lacuna entre o recrutamento e o gerenciamento de TI, garantindo que as novas contratações sejam integradas de forma rápida e segura, com os direitos de acesso necessários.

### Provisionamento automático de usuário

Configure automaticamente contas de usuário e conceda as permissões necessárias no AD, Exchange e Microsoft 365 quando novos registros de colaboradores forem adicionados ao Workable.

### Sincronização de dados de usuários

Sincronize dados de colaboradores no AD, Exchange, Microsoft 365 e outros sistemas.

## Como integrar o ADManager Plus e o Workable

**Pré-requisitos**

Certifique-se de fornecer o [bearer token](https://workable.readme.io/reference/create-employee) para acessar as informações desejadas e executar tarefas no Workable. Consulte as [referências de API do Workable](https://workable.readme.io/reference/create-employee) para mais detalhes.

**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 Workable (ação de saída): A conta usada deve ter permissão para realizar a ação desejada.

**Nota:** O ADManager Plus oferece um conjunto pré-configurado de APIs para efetuar as ações básicas da integração. Se a ação que você precisa não estiver disponível, consulte a referência de API do Workable 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

- Faça login no **ADManager Plus** e acesse a guia **Automation**.
- No painel esquerdo, em Configuration, clique em **Application Integrations**.
- Em Enterprise Applications, clique em **Workable**.
- Ative o botão **Enable Workable Integration**.
- Na página Workable Configuration, clique em **Authorization**.
- Execute as [etapas para gerar o bearer token no Workable](https://workable.readme.io/reference/create-employee) e cole o bearer token no **campo Value**.
- Clique em **Configure**.

## Configuração de webhook de entrada

Os webhooks de entrada permitem que você obtenha dados do usuário diretamente do Workable 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 Workable:

1. Em Inbound Webhook, clique em **Workable Endpoint Configuration**.
2. Na guia Endpoint Configuration, o ENDPOINT DE USUÁRIOS do Workable, vem pré-configurado com campos **URL do endpoint, Método de API, Cabeçalhos** e **Parâmetros** para obter contas de usuário do Workable. Se desejar usar esse endpoint pré-configurado, substitua {subdomain} pelo da sua instância Workable 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 da Workable](https://workable.readme.io/reference/create-employee). 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 Workable](https://workable.readme.io/reference/create-employee) e configure cabeçalhos e parâmetros adicionais, se necessário.
3. Após concluir, clique em **Test e 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**.

   **Nota:**

   - Consulte as [referências de API do Workable](https://workable.readme.io/reference/create-employee) para saber os **parâmetros** que devem ser configurados para obter apenas parâmetros específicos.
   - Você pode configurar diversos endpoints para o Workable 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 Workable.
5. Clique em **+ Add New Configuration** e faça o seguinte:
   - Insira o **Nome da configuração** e a **Descrição**, e selecione a **Categoria de automação** no menu suspenso.
   - No campo Select Endpoint, selecione o **endpoint** desejado e uma **Chave primária** exclusiva a cada usuário (por exemplo, employeeIdentifier).

     **Nota:** Quando vários endpoints estiverem configurados, essa chave deve manter o mesmo valor em todos eles.

   - No campo Attribute Mapping, selecione o atributo no menu suspenso LDAP Attribute Name e associe ele ao atributo correspondente no Workable.
   - Se você quiser criar um novo formato personalizado para isso, clique em **Add New Format**.
   - Clique em **Save.**

## Configuração de webhook de saída

Um webhook de saída permite enviar alterações feitas no AD para usando o ADManager Plus to Workable e executar tarefas no Workable - diretamente do ADManager Plus. Os webhooks configurados nesta seção podem ser incluídos em [Modelos de orquestração](https://www.manageengine.com/products/ad-manager/help/orchestration/new-orchestration-template.html), que, por sua vez, podem ser usados nas [automações acionadas por eventos](https://www.manageengine.com/products/ad-manager/help/orchestration/orchestration-profile.html) e [automações agendadas](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html). Eles também podem ser aplicados diretamente aos usuários desejados para executar uma sequência de ações neles (**Management** > **Advanced Management** > **Orchestration**). Para configurar um webhook de saída para o Workable:

1. Em Outbound Webhook, clique em **Workable Webhook Configuration**.
2. Clique em **+ Add Webhook**.
3. Insira um **nome** e uma **descrição** para este webhook.
4. Decida sobre a ação que deve ser executada e consulte as [referências de API do Workable](https://workable.readme.io/reference/create-employee) para obter os detalhes de API, tais como URL, cabeçalhos, parâmetros e outros requisitos que serão necessários.
5. Selecione, no menu suspenso, o método HTTP que permitirá executar a ação desejada no endpoint.
6. Insira a URL do endpoint.
7. Configure os cabeçalhos, os parâmetros e o tipo de mensagem no formato apropriado com base na chamada de API que você deseja executar.
8. Clique em **Test and Save**.
9. Uma janela pop-up exibirá uma lista de usuários e grupos do AD para testar a chamada de API configurada. Selecione o usuário ou grupo desejado para testar a chamada de API e clique em **OK**. Isso enviará uma solicitação em tempo real para a URL do endpoint e aplicará as modificações configuradas aos objetos selecionados.
10. Os detalhes da solicitação e da resposta do webhook serão exibidos. Verifique se a API está respondendo corretamente e clique em **Save**.