Configure um webhook bidirecional para o spoke do Box

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

Antes de Iniciar

• Solicitar uma assinatura de IntegrationHub.
• Ative o spoke do Box.
• Função necessária: administrador

Adicione um 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 Crie uma aplicação OAuth.

3. Gere uma chave primária e uma chave secundária para o app e registre os valores.
   1. Em Minhas aplicações , selecione a aplicação.
      Você está na sua aplicação Configurações gerais .
   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é Webhooks seção.
5. Para criar um webhook V1, selecione Criar webhook e selecione V1 .
   1. Preencha os campos:

      Campo	Valor
      Nome	Atualizar feed do Chatter
      Descrição	Atualiza automaticamente seu feed do Chatter quando ocorre uma mudança
      Tipo de evento	Habilite pelo menos uma opção
      URL de endpoint	O URL do endpoint do ServiceNow instância no seguinte formato: https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint
      Formato de 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 qualquer método GET ou POST

   2. Selecione Salve Webhoook .
6. Para criar um webhook V2, selecione Criar webhook e selecione V2 .
   Nota:

   Para criar um webhook V2, você deve habilitar Gerenciar webhooks em Configuração configurações. Para obter mais informações, consulte Crie uma aplicação OAuth.
   1. Em Endereço da URL, insira a URL do endpoint do ServiceNow instância no seguinte formato: https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint .
   2. Para o tipo de item para acionar um webhook, selecione Escolha um item .
   3. Selecione o arquivo ou as pastas configuradas do webhook.
   4. Para confirmar, selecione Escolha .
      Uma lista de gatilhos de webhook configurados é exibida no Crie um webhook página.
   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 e subfluxos de webhook de acordo com seus requisitos.

Registre um webhook do Box na ServiceNow

Crie um registro de webhook do Box na ServiceNow para notificar o aplicativo 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é Tudo > Caixa > Registro do webhook pronto para uso.
2. Selecione Novo.
3. Preencha os campos.

   Campo	Valor
   Nome	Como opção, 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 Adicione um 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 Adicione um URL de endpoint em uma conta do Box
   Descrição	Descreva a finalidade do registro

4. Para confirmar, selecione Enviar .

Resultado

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