¿Cómo crear un webhook desde la aplicación REST con el token de acceso generado a partir del proceso de OAuth mediante la URL de webhook creada desde Azure AD? | Adobe Sign

Última actualización el 27 abr 2021

Objetivo

¿Cómo crear un webhook desde una aplicación REST con un token de acceso generado desde el proceso OAuth usando una URL de webhook creada desde Azure AD?

Entorno

API REST de Adobe Sign V6

Pasos

Para crear un webhook directamente desde la interfaz de usuario de Adobe Sign, en primer lugar cree la URL de webhook a través de las aplicaciones de la función Azure AD; para ello, siga los pasos que se indican a continuación:

Inicie sesión con la cuenta de Microsoft https://portal.azure.com/.

Regístrese en Function Apps bajo la cuenta de AzureAD.

Vaya a AzureAD y acceda a Function Apps > Haga clic en el icono + para Functions.

Seleccione Webhook+API con JavaScript como lenguaje y haga clic en Crear función.

Reemplace el archivo Index.js por el siguiente fragmento de código:

Haga clic en el botón Test en la esquina derecha y proporcione el siguiente encabezado:

X-AdobeSign-ClientId as ***********************

Haga clic en Guardar y Ejecutar.

Una vez que reciba la respuesta 200 OK con el siguiente encabezado, haga clic en Get function URL

Copie la URL y vaya a la interfaz de usuario de Adobe Sign > Webhooks > Haga clic en el icono + para crear.

Introduzca la siguiente información: 

  • Nombre: Se sugiere un nombre intuitivo que otros administradores puedan entender fácilmente.
  • Ámbito: Qué tan amplia es la red que está capturando el webhook.La cuenta y el grupo están disponibles en la interfaz.
    La API es compatible con los ámbitos de Cuenta, Grupo, Usuario y Recursos.
  • Únicamente se puede definir un Ámbito por webhook
  • URL: La URL de destino a la que Adobe Sign envió la carga útil JSON.
  • Eventos: El activador que hace que Adobe Sign genere el JSON y lo envíe a la URL.
    Cada evento genera una carga útil diferente relevante para el evento activador
    Se pueden incluir varios eventos en un webhook.
  • Parámetros de notificación: Los Parámetros de notificación identifican las secciones de la carga JSON del evento, lo que le permite seleccionar solo las secciones del evento que son importantes.

Una vez que el webhook esté completamente definido, haga clic en Save, y el nuevo webhook comenzará a reaccionar a los eventos activadores inmediatamente.