Configurar um webhook bidirecional para o spoke do Box

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

    • Configure um webhook para assinar o Box com uma URL de retorno de chamada da ServiceNow.

    Antes de Iniciar

    • Solicitar uma assinatura do IntegrationHub Professional
    • Ativar o spoke do Box
    • Função necessária: administrador

    Adicionar uma URL de endpoint em uma conta do Box

    Especifique um URL de endpoint em sua conta do Box para criar um webhook para o spoke do Box.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Faça login no console do desenvolvedor do Box.
    2. Crie um app de acordo com seus requisitos.

      Para obter mais informações sobre a criação de apps, consulte Criar uma aplicação OAuth.

    3. Gere uma chave primária e uma chave secundária para sua aplicação e registre os valores.
      1. Em Meus apps, selecione a aplicação.
        Você está nas Configurações geraisda sua aplicação.
      2. Navegue até Webhooks.
      3. Selecione Gerenciar chaves de assinatura.
      4. Na seção Chave primária, selecione Gerar chave.
      5. Na seção Chave secundária, selecione Gerar chave.
      6. Copie e salve ambos os valores de chave para mais tarde.
    4. Navegue até a seção Webhooks.
    5. Para criar um webhook V1, selecione Criar Webhook e selecione V1.
      1. Preencha os campos:

        Campo

        Valor

        Nome

        Atualizar feed de conversas

        Descrição

        Atualiza automaticamente o feed do Chatter quando ocorre uma mudança

        Tipo de evento

        		 Habilite pelo menos uma opção

        URL de endpoint

        O URL do endpoint da instância ServiceNow no seguinte formato: https://<instance-name> .service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint

        Formato da carga

        Selecione o formato de dados de carga apropriado

        Parâmetros de retorno de chamada

        Selecione adicionar parâmetro de retorno de chamada para configurar métodos GET ou POST
      2. Selecione Salvar webhook.
    6. Para criar um webhook V2, selecione Criar Webhook e selecione V2.
      Nota:
      Para criar um webhook V2, você deve habilitar Gerenciar webhooks nas definições de configuração. Para obter mais informações, consulte Criar uma aplicação OAuth.
      1. Para o Endereço URL, insira o URL do endpoint da instância ServiceNow no seguinte formato: https://<instance-name> .service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint .
      2. Em O tipo de item para acionar um webhook, selecione Escolher um item.
      3. Selecione o arquivo ou as pastas configuradas do webhook.
      4. Para confirmar, selecione Escolher.
        Uma lista de gatilhos de webhook configurados é exibida na página Criar um Webhook.
      5. Habilite os métodos GET e POST apropriados para cada gatilho.
      6. Para confirmar, selecione Criar webhook.

    Resultado

    O URL do endpoint é adicionado à sua conta do Box. Você pode criar registros de webhook e subfluxos de acordo com seus requisitos.

    Registrar um webhook do Box na ServiceNow

    Crie um registro de webhook do Box na ServiceNow para notificar o aplicativo da ServiceNow quando determinados eventos ocorrerem em sua conta do Box.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Em seu ServiceNow, navegue até Todos > Caixa > Registro do webhook pronto para uso.
    2. Selecione Novo.
    3. Preencha os campos.

      Campo

      Valor

      Nome

      Opcionalmente, nomeie o registro do webhook

      Nome do gatilho

      Selecione o gatilho de evento apropriado

      Chave primária

      A chave primária que você gerou em Adicionar uma URL de endpoint em uma conta do Box

      Nome de Fluxo

      O fluxo que ocorre quando o evento é acionado

      Chave secundária

      A chave secundária que você gerou em Adicionar uma URL de endpoint em uma conta do Box

      Descrição

      Opcionalmente, descreva a finalidade do registro
    4. Para confirmar, selecione Enviar.

    Resultado

    O webhook do Box está registrado em sua instância da ServiceNow.