Como integrar com Calendly

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura

    • A integração da aplicação Gestão de ativos de software com o serviço Calendly permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    Importante:
    Minimize os riscos de segurança e proteja as informações concedendo acesso somente ao usuário ou às permissões de API necessárias.
    Tabela 1. Permissões mínimas do usuário
    Processo Função do usuário necessária na aplicação Calendly Escopos de autenticação
    Baixar assinaturas administrador Nenhum(a)
    Extrair atividade do usuário administrador Nenhum(a)
    Recuperar assinatura administrador Nenhum(a)

    Criar uma Calendly aplicação OAuth

    Registre uma aplicação pública com o serviço Calendly para que você possa acessar a API Calendly usando o OAuth 2.0.

    Antes de Iniciar

    Calendly Função necessária: administrador

    Você deve ter uma conta Google ou GitHub para se inscrever para um desenvolvedor Calendly.

    Procedimento

    1. Navegue até Calendly Portal do desenvolvedor.
      • Se você já tiver uma conta de desenvolvedor Calendly, entre com suas credenciais e vá para a etapa 3.
      • Se você não tiver uma conta de desenvolvedor Calendly, conclua a etapa 2.
    2. Opcional: Inscreva-se em uma conta de desenvolvedor Calendly por meio de sua conta GitHub ou Google, selecionando Inscrever- se no canto superior direito da página do site do desenvolvedor Calendly.
      Esta conta não está associada à sua conta de usuário Calendly Google.
    3. Navegar até Conta > Minhas apps para criar uma aplicação OAuth.
    4. Selecione Criar um novo app.
    5. No formulário, preencha os campos.
      Tabela 2. Formulário Criar app OAuth
      Campo Descrição
      Nome da aplicação Nome da sua aplicação.
      Tipo de app O tipo de aplicação, como Web ou Nativo.
      Tipo de ambiente O tipo de ambiente ao qual você deseja associar sua aplicação, como Sandbox ou Produção.
      Redirecionar URI ServiceNow URL de redirecionamento. Por exemplo, https://app.example.com/auth.
    6. Selecione Salvar e continuar.

    O que Fazer Depois

    Copie o ID do cliente e o segredo do cliente.

    Importante:

    Você deve copiar esses valores, pois não poderá acessar o segredo do cliente novamente.

    Criação do perfil de Integração Calendly

    Crie um perfil de integração para rastrear assinaturas de software e otimizar licenças obsoletas para o serviço Calendly.

    Antes de Iniciar

    Para criar um perfil de integração Calendly, solicite Gestão de ativos de software - Gestão de licenças de SaaS (com.sn_sam_saas_int) na ServiceNow Store.

    ServiceNow Função necessária: sam_integrator ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando Espaço para ativos de software, a opção para criar o perfil de integração [ Calendly em IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Todos > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione o perfil de integração do Calendly.
      Espaço de ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração direta.
      2. Selecione Novo.
      3. Selecione Calendly na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 3. Formulário Perfil de integração
      Campo Descrição
      Nome de exibição Nome do perfil de integração. Por exemplo, Integração Calendly.
      Conexão e Credencial Alias de conexão e credencial para o spoke Calendly.

      Este campo é definido automaticamente como sn_calendly_spoke.Calendly.
      Status Status do perfil de integração.
      • Se você não publicou o perfil de integração, este campo será definido automaticamente como Rascunho.
      • Se você já publicou o perfil de integração, este campo será definido automaticamente como Publicado.
      Tipo de Perfil Tipo de perfil de integração.

      Este campo é definido automaticamente como Assinatura Calendly.
    3. Na guia Baixar Subfluxo de Assinatura, verifique se o campo Subfluxo está definido como Subfluxo de Assinaturas de Download Calendário.
    4. Na guia Calcular Subfluxo de Atividade, verifique se o campo Subfluxo está definido como Atualizar Calendalmente o Subfluxo de Atividade do Usuário.
      Você também pode selecionar a data e a hora em que deseja analisar a atividade do usuário no campo Analisar atividade do usuário de. Por padrão, você pode analisar a atividade do usuário até 60 dias antes da data atual e exibir eventos realizados por usuários individuais a partir do momento em que cria este perfil.
      Nota:
      Gestão de ativos de software extrai os eventos a partir do momento em que você começa a analisar a atividade do usuário, independentemente da data de criação do perfil.
      Você pode modificar este valor no campo Limite de última atividade das regras de recuperação de software. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
    5. Na guia Recuperar Subfluxo de Assinatura, verifique se o campo Subfluxo está definido como Recuperar Assinatura Calendly.
    6. Selecione Salvar.
      Sua instância ServiceNow cria um perfil de integração de rascunho. O perfil de integração usa os subfluxos Calendly Baixar assinaturas, Calendly Atualizar atividade do usuário e Calendly Recuperar assinatura para recuperar dados do usuário do serviço Calendly.
    7. Abra o registro de aliases de conexão e credencial selecionando o ícone de visualização (ícone de visualização) ao lado do campo Conexão e credencial e selecionando Abrir registro na visualização do registro.
    8. No formulário Aliases de conexão e credencial, selecione o link relacionado Criar nova conexão e credencial.
    9. Na caixa de diálogo, preencha os campos.
      Tabela 4. Caixa de diálogo Criar conexão e credencial
      Campo Descrição
      Nome da conexão O nome da conexão.
      URL de Conexão URL base para a API Calendly. Este campo é definido automaticamente como https://api.calendly.com.
      ID do cliente OAuth ID de cliente atribuído à aplicação pública que você registrou com o serviço Calendly.
      Segredo do cliente OAuth Segredo do cliente atribuído à aplicação pública que você registrou com o serviço Calendly.
      URL de redirecionamento do OAuth URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação.

      Este campo é preenchido automaticamente com base no nome da sua instância.
    10. Selecione Criar e obter um Token do OAuth.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
    11. Na caixa de diálogo Autorizar app, faça login na sua conta Calendly.
      A caixa de diálogo é fechada e você retorna automaticamente ao formulário de perfil de integração.
    12. Selecione Publicar.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de usuário que são atualizadas diariamente.

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revisar uma regra de recuperação de software.

    Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software de propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licenças (Gestão de ativos de software aplicação clássica) ou na exibição de uso de licença (Software Asset Workspace). Use esses resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.