Guía del usuario Cancelar

Información general de Acrobat Sign Webhook

 

Guía de Adobe Acrobat Sign

Novedades

  1. Notas previas a la versión
  2. Notas de la versión
  3. Notificaciones importantes

Introducción

  1. Guía de inicio rápido para administradores
  2. Guía de inicio rápido para usuarios
  3. Para desarrolladores
  4. Biblioteca de tutoriales de vídeo
  5. Preguntas frecuentes

Administrar

  1. Información general sobre Admin Console
  2. Administración de usuarios
    1. Agregación de usuarios
      1. Agregar un usuario
      2. Añadir usuarios en bloque
      3. Añadir usuarios desde el directorio
      4. Añadir usuarios desde MS Azure Active Directory
    2. Crear usuarios centrados en funciones
      1. Cuentas técnicas - basadas en API
      2. Cuentas de servicio - Manejadas manualmente
    3. Buscar usuarios con errores de aprovisionamiento
    4. Cambiar nombre/dirección de correo electrónico
    5. Editar los miembros del grupo de un usuario
    6. Editar los miembros del grupo de un usuario a través de la interfaz de grupo
    7. Promover un usuario a una función de administrador
    8. Tipos de identidad de usuario y SSO
    9. Cambiar identidad de usuario
    10. Autenticar usuarios con MS Azure
    11. Autenticar usuarios con la federación de Google
    12. Perfiles de productos
    13. Experiencia de inicio de sesión 
  3. Configuración de cuenta/grupo
    1. Descripción general de configuración
    2. Configuración global
      1. Nivel de cuenta e ID
      2. Nueva experiencia de destinatario
      3. Flujos de trabajo de firma automática
      4. Enviar en bloque
      5. Formulario web
      6. Flujos de trabajo de envío personalizado
      7. Flujos de trabajo de Power Automate
      8. Documentos de la biblioteca
      9. Recopilar los datos de formularios con acuerdos
      10. Visibilidad limitada de los documentos
      11. Adjuntar una copia de PDF del acuerdo firmado
      12. Incluir un vínculo en el correo electrónico
      13. Incluir una imagen en el correo electrónico
      14. Los archivos adjuntos a correos electrónicos recibirán el nombre
      15. Adjuntar informe de auditoría a documentos
      16. Combinar varios documentos en uno solo
      17. Descargar documentos individuales
      18. Carga de un documento firmado
      19. Delegación para usuarios de mi cuenta
      20. Permitir delegar a destinatarios externos
      21. Autoridad para firmar
      22. Autoridad para enviar
      23. Potestad para añadir sellos electrónicos
      24. Establecer la zona horaria predeterminada
      25. Establecer un formato de fecha predeterminado
      26. Usuarios en varios grupos (UMG)
        1. Actualizar para usar UMG
      27. Permisos de administrador de grupos
      28. Reemplazar destinatario
      29. Informe de auditoría
        1. Información general
        2. Permitir acceso no autenticado en la página de verificación de la transacción
        3. Incluir recordatorios
        4. Incluir eventos de vista
        5. Incluir recuento de páginas del acuerdo/archivos adjuntos
      30. Mensajería en el producto y guías
      31. PDF accesibles
      32. Nueva experiencia de creación
      33. Cliente sanitario
    3. Configuración de cuenta
      1. Añadir logotipo
      2. Personalizar el nombre de host/URL de la empresa   
      3. Agregar el nombre de empresa
      4. Redirección de URL posterior al acuerdo
    4. Preferencias de firma
      1. Firmas con el formato correcto
      2. Permitir a los destinatarios firmar mediante
      3. Los firmantes pueden cambiar su nombre
      4. Permitir que los destinatarios utilicen su firma guardada
      5. Condiciones de uso personalizadas y divulgación del cliente
      6. Desplazarse por los destinatarios en los campos del formulario
      7. Rechazo de la firma
      8. Permitir flujos de trabajo de Stamps
      9. Solicitar a los firmantes que proporcionen su Título o Empresa
      10. Permitir a los firmantes imprimir y colocar una firma escrita
      11. Mostrar mensajes al firmar electrónicamente
      12. Requerir a los firmantes usar un dispositivo móvil para crear su firma
      13. Solicitar la dirección IP de los firmantes
      14. Excluir el nombre y cargo de la empresa de los sellos de participación
    5. Firmas digitales
      1. Información general
      2. Descargar y firmar con Acrobat
      3. Firmar con firmas en la nube
      4. Incluir metadatos para proveedores de identidad
      5. Proveedores de firma en la nube restringidos
    6. Sellos electrónicos
    7. Identidad digital
      1. Puerta de enlace de identidad digital
      2. Política de comprobación de identidad
    8. Configuración de informes
      1. Nueva experiencia de informes
      2. Configuración de informes clásica
    9. Configuración de seguridad
      1. Configuración de inicio de sesión único
      2. Configuración de recordar usuario
      3. Política de contraseña para inicio de sesión
      4. Seguridad de la contraseña del inicio de sesión
      5. Duración de la sesión web
      6. Tipo de encriptación del PDF
      7. API
      8. Acceso a la información de usuarios y grupos
      9. Rangos de IP permitidos
      10. Uso compartido de cuenta
      11. Permisos de cuenta compartida
      12. Controles de uso compartido de acuerdos
      13. Verificación de la identidad del firmante
      14. Contraseña de firma de acuerdo
      15. Seguridad de la contraseña del documento
      16. Bloqueo de firmantes por geolocalización
      17. Autenticación telefónica
      18. Autenticación basada en conocimientos (KBA)
      19. Permitir la extracción de página
      20. Expiración del vínculo a documentos
      21. Cargar un certificado de cliente para webhooks/devoluciones de llamada
      22. Marca de hora
    10. Configuración de envío
      1. Mostrar página Enviar después de iniciar sesión
      2. Requerir el nombre del destinatario al enviar
      3. Bloquear valores de nombre para usuarios conocidos
      4. Funciones de destinatarios permitidos
      5. Permitir testigos electrónicos
      6. Grupos de destinatarios
      7. Campos obligatorios
      8. Adjuntar documentos
      9. Integración de campos
      10. Modificar acuerdos
      11. Nombre del acuerdo
      12. Idiomas
      13. Mensajes privados
      14. Tipos de firma permitidos
      15. Recordatorios
      16. Protección con contraseña de documentos firmados
      17. Enviar notificación de acuerdo a través de
      18. Opciones de identificación del firmante
        1. Información general
        2. Contraseña de firma
        3. Contraseña de un solo uso por correo electrónico
        4. Autenticación de Acrobat Sign
        5. Autenticación telefónica
        6. Firma digital basada en la nube
        7. Autenticación basada en conocimientos
        8. ID gubernamental
        9. Informes de identidad del firmante
      19. Protección de contenidos
      20. Habilitar transacciones de Notarize
      21. Caducidad del documento
      22. Vista previa, colocar firmas y añadir campos
      23. Orden de las firmas
      24. Liquid Mode
      25. Controles de flujo de trabajo personalizado
      26. Opciones de carga para la página de firma electrónica
      27. Redirección de la URL de confirmación tras la firma
    11. Plantillas de mensajes
    12. Configuración biofarmacéutica
      1. Información general
      2. Obligatoriedad de la autenticación de la identidad
      3. Motivos de firma
    13. Integración del flujo de trabajo
    14. Configuración de notarización
    15. Integración de pagos
    16. Mensajería de los firmantes
    17. Configuración de SAML
      1. Configuración de SAML
      2. Instalar el Servicio de federación de Microsoft Active Directory
      3. Instalar Okta
      4. Instalar OneLogin
      5. Instalar federación de identidades de Oracle
    18. Gobernanza de datos
    19. Configuración de marca de tiempo
    20. Archivo externo
    21. Idiomas de la cuenta
    22. Configuración de correo electrónico
      1. Imágenes de encabezado y pie de página del correo electrónico
      2. Permitir pies de página de correo electrónico de usuarios individuales
      3. Personalizar el correo electrónico de Firma solicitada
      4. Personalizar los campos “Para” y “CC”
      5. Habilitar notificaciones sin enlaces
      6. Personalice plantillas de correo electrónico
    23. Migración de echosign.com a adobesign.com
    24. Configuración de las opciones para los destinatarios
  4. Orientación para los requisitos reglamentarios
    1. Accesibilidad
      1. Cumplimiento de accesibilidad
      2. Crear formularios accesibles con Acrobat para escritorio
      3. Crear AcroForms accesibles
    2. HIPAA
    3. RGPD
      1. Información general sobre el RGPD
      2. Redactar a un usuario
      3. Redactar los acuerdos de un usuario    
    4. Título 21 del CFR, Parte 11, y EudraLex, anexo 11
      1. Paquete de validación del Título 21 del CFR, Parte 11
      2. Manual del Título 21 del CFR y EudraLex Anexo 11
      3. Análisis de las responsabilidades compartidas
    5. Clientes del sector sanitario
    6. Compatibilidad con IVES
    7. Acuerdos de "protección"
    8. Consideraciones de la UE y el Reino Unido
      1. Transacciones transfronterizas de la UE y el Reino Unido e IDAS
      2. Requisitos de HMLR para los títulos firmados electrónicamente
      3. El impacto del Brexit en las leyes de firma electrónica en el Reino Unido
  5. Descargar acuerdos en bloque
  6. Reivindicar un dominio 
  7. Vínculos de notificación de abuso

Enviar, firmar y administrar acuerdos

  1. Opciones de destinatario
    1. Cancelar un recordatorio por correo electrónico
    2. Opciones de la página de firma electrónica
      1. Información general de la página de firma electrónica
      2. Abrir para leer el acuerdo sin campos
      3. Rechazar la firma de un acuerdo
      4. Delegar autorización de firma
      5. Reiniciar el acuerdo
      6. Descargar un PDF del acuerdo
      7. Ver el historial del acuerdo
      8. Ver los mensajes del acuerdo
      9. Conversión de una firma electrónica a una escrita
      10. Conversión de una firma escrita a una electrónica 
      11. Navegar por los campos de formulario
      12. Borrar los datos de los campos de formulario
      13. Ampliación y navegación por la página de firma electrónica
      14. Cambiar el idioma utilizado en las herramientas y la información del acuerdo
      15. Revisar los avisos legales
      16. Ajuste de las preferencias de cookies de Acrobat Sign
  2. Enviar acuerdos  
    1. Información general de la página Enviar
    2. Envía un acuerdo solo a ti
    3. Enviar un acuerdo a otros usuarios
    4. Firmas escritas
    5. Orden de firma de los destinatarios
    6. Enviar en bloque
      1. Descripción general de la función Enviar en bloque
      2. Enviar en lote: configurar una plantilla principal
      3. Enviar en lote: configurar con el archivo CSV
      4. Cancelación de una transacción Enviar en lote
      5. Añadir recordatorios a Enviar en lote
      6. Creación de informes para Enviar en lote
  3. Creación de campos en documentos
    1. Entorno de creación en la aplicación
      1. Detección automática de campos
      2. Arrastra y suelta campos con el entorno de creación
      3. Asignación de los campos de formulario a los destinatarios
      4. La función Rellenar previamente
      5. Aplicar campos con una plantilla de campos reutilizable
      6. Transferir campos a una nueva plantilla de biblioteca
      7. Entorno de creación actualizada al enviar acuerdos
    2. Creación de formularios y etiquetas de texto
    3. Creación de formularios con Acrobat (AcroForms)
      1. Creación de AcroForm
      2. Crear documentos PDF accesibles
    4. Campos
      1. Tipos de campo
        1. Tipos de campo comunes
        2. Imágenes en línea
        3. Imágenes de sello
      2. Aspecto del contenido del campo
      3. Validaciones de campo
      4. Valores de campos enmascarados
      5. Configuración de condiciones de mostrar/ocultar
      6. Campos calculados 
    5. Preguntas frecuentes sobre creación
  4. Firmar acuerdos
    1. Firmar los acuerdos que te envíen
    2. Rellenar y firmar
    3. Firma automática
  5. Gestionar acuerdos
    1. Información general de la página Administrar
    2. Acuerdos delegados
    3. Reemplazar destinatarios
    4. Limitar la visibilidad del documento 
    5. Cancelar un acuerdo 
    6. Crear nuevos recordatorios
    7. Revisar recordatorios
    8. Cancelación de un recordatorio
    9. Acceder a flujos de Power Automate
    10. Más acciones…
      1. Cómo funciona la búsqueda
      2. Ver un acuerdo
      3. Creación de una plantilla a partir de un acuerdo
      4. Ocultar/Mostrar acuerdos de la vista
      5. Cargar un documento firmado
      6. Modificar los archivos y campos de un acuerdo enviado
      7. Editar el método de autenticación de un destinatario
      8. Añadir o modificar una fecha de caducidad
      9. Añadir una nota al acuerdo
      10. Uso compartido de un acuerdo individual
      11. Anular uso compartido de un acuerdo
      12. Descargar un acuerdo individual
      13. Descarga de los archivos individuales de un acuerdo
      14. Descargar el informe de auditoría de un acuerdo
      15. Descargar el contenido del campo de un acuerdo
  6. Informe de auditoría
  7. Exportaciones de creación de informes y datos
    1. Información general
    2. Conceder a los usuarios acceso a la creación de informes
    3. Gráficos de informes
      1. Crear un informe nuevo
      2. Informes del acuerdo
      3. Informes de transacciones
      4. Informe de actividad de la configuración
      5. Editar un informe
    4. Exportaciones de datos 
      1. Para crear una nueva exportación de datos
      2. Edición de una exportación de datos
      3. Actualizar el contenido de exportación de datos
      4. Descargar la exportación de datos
    5. Cambio de nombre de un gráfico/exportación
    6. Duplicar un informe/exportación
    7. Programar un informe/exportación
    8. Eliminar un informe/exportación
    9. Comprobar uso de transacciones

Capacidades y flujos de trabajo de acuerdos avanzados

  1. Formularios web 
    1. Crear un formulario web
    2. Editar un formulario web
    3. Deshabilitación/habilitación de un formulario web
    4. Ocultación/descubrimiento de un formulario web
    5. Buscar la dirección URL o el código de script 
    6. Rellenar previamente los campos del formulario web con parámetros de URL
    7. Guardar un formulario web para completarlo más tarde
    8. Cambiar el tamaño de un formulario web
  2. Plantillas reutilizables (plantillas de la biblioteca) 
    1. Formularios del Gobierno de los EE. UU. en la biblioteca de Acrobat Sign
    2. Crear una plantilla de biblioteca
    3. Cambiar el nombre de una plantilla de biblioteca
    4. Cambiar el tipo de una plantilla de biblioteca
    5. Cambio del nivel de permisos de una plantilla de biblioteca
    6. Copiar, editar y guardar una plantilla compartida
    7. Descargar los datos de campos agregados para una plantilla de biblioteca
  3. Transferencia de la propiedad de formularios web y plantillas de biblioteca
  4. Flujos de trabajo de Power Automate 
    1. Información general sobre la integración de Power Automate y los derechos incluidos
    2. Habilitar la integración de Power Automate
    3. Acciones en contexto de la página Administrar
    4. Seguimiento del uso de Power Automate
    5. Crear un nuevo flujo (Ejemplos)
    6. Desencadenadores utilizados para flujos
    7. Importación de flujos desde fuera de Acrobat Sign
    8. Administrar flujos
    9. Editar flujos
    10. Compartir flujos
    11. Deshabilitar o habilitar flujos
    12. Eliminar flujos
    13. Plantillas útiles
      1. Solo administrador
        1. Guardar todos los documentos completados en SharePoint
        2. Guardar todos los documentos completados en OneDrive para empresas
        3. Guardar todos los documentos completados en Google Drive
        4. Guardar todos los documentos completados en Dropbox
        5. Guardar todos los documentos completados en Box
      2. Archivo de acuerdos
        1. Guarde los documentos completados en SharePoint
        2. Guardar los documentos completados en OneDrive para empresas
        3. Guardar los documentos completados en Google Drive
        4. Guardar todos los documentos completados en Dropbox
        5. Guardar los documentos completados en Box
      3. Archivo de acuerdos del formulario web
        1. Guardar documentos de formulario web completados en la biblioteca de SharePoint
        2. Guardar documentos de formularios web completados en OneDrive para empresas
        3. Guardar los documentos completados en Google Drive
        4. Guardar los documentos de formularios web completados en Box
      4. Extracción de datos del acuerdo
        1. Extraer datos de campos de formulario del documento firmado y actualizar la hoja de Excel
      5. Notificaciones del acuerdo
        1. Enviar notificaciones por correo electrónico personalizadas con el contenido del acuerdo y el acuerdo firmado
        2. Obtener notificaciones de Adobe Acrobat Sign en un canal de Teams
        3. Obtener las notificaciones de Adobe Acrobat Sign en Slack
        4. Obtener las notificaciones de Adobe Acrobat Sign en Webex
      6. Generación de acuerdos
        1. Generar el documento a partir del formulario de Power App y la plantilla de Word; enviar para firmar
        2. Generar un acuerdo a partir de una plantilla de Word en OneDrive y obtener la firma
        3. Generar un acuerdo para la fila de Excel seleccionada, enviar para revisión y firmar
  5. Flujos de trabajo de envío personalizado
    1. Información general del flujo de trabajo de envío personalizado
    2. Creación de un nuevo flujo de trabajo de envío
    3. Edición de un flujo de trabajo de envío
    4. Activar o desactivar un flujo de trabajo de envío
    5. Enviar un acuerdo con un flujo de trabajo de envío
  6. Compartir usuarios y acuerdos
    1. Compartir un usuario
    2. Compartir acuerdos

Integrar con otros productos

  1.  Introducción a las integraciones de Acrobat Sign 
  2. Acrobat Sign para Salesforce
  3. Acrobat Sign para Microsoft
    1. Acrobat Sign para Microsoft 365
    2. Acrobat Sign para Outlook
    3. Acrobat Sign para Word/PowerPoint
    4. Acrobat Sign para Teams
    5. Acrobat Sign para Microsoft PowerApps y Power Automate
    6. Conector de Acrobat Sign para Microsoft Search
    7. Acrobat Sign para Microsoft Dynamics 
    8. Acrobat Sign para Microsoft SharePoint 
  4. Otras integraciones
    1. Acrobat Sign para ServiceNow
    2. Acrobat Sign para HR ServiceNow
    3. Acrobat Sign para SAP SuccessFactors
    4. Acrobat Sign para Workday
    5. Acrobat Sign para NetSuite
    6. Acrobat Sign para VeevaVault
    7. Acrobat Sign para Coupa BSM Suite
  5. Integraciones gestionadas por socios
  6. Cómo se crea una clave de integración

Acrobat Sign Desarrolladores

  1. API REST 
    1. Documentación de métodos
    2. Guía de desarrollo/SDK
    3. Preguntas frecuentes sobre API    
  2. Webhooks 
    1. Introducción a Webhook
    2. Configurar un webhook nuevo
    3. Ver o editar un webhook
    4. Desactivar o reactivar un webhook
    5. Eliminar un webhook
    6. Certificados SSL bidireccionales
    7. Webhooks en la API

Soporte y solución de problemas

  1. Recursos de asistencia al cliente 
  2. Recursos de éxito de los clientes de empresa 

Información general

Un webhook es una solicitud HTTPS definida por el usuario que se activa cuando se produce un evento determinado en el sitio de origen (Adobe Acrobat Sign, en este caso).

Por lo tanto, un webhook es simplemente un servicio REST que acepta datos o un flujo de datos.

Los webhooks están pensados para la comunicación de servicio a servicio en un modelo PUSH.

Cuando se activa un evento suscrito, Acrobat Sign crea un POST HTTPS con un cuerpo JSON y lo envía a la dirección URL especificada.

Antes de configurar los webhooks, asegúrese de que la red acepta los intervalos de IP necesarios para la funcionalidad.

 

Los webhooks ofrecen varias ventajas sobre el método de devolución de llamada anterior, algunas de las cuales son las siguientes:

  • Los administradores pueden habilitar sus propios webhooks sin tener que involucrar al soporte técnico de Acrobat Sign para que muestre la URL de devolución de llamada
  • Los webhooks son mejores en términos del estado de actualización de los datos, de la eficiencia de la comunicación y de la seguridad. No se requiere votación
  • Los webhooks permiten diferentes niveles de ámbito (cuenta/grupo/usuario/recurso) fácilmente. 
  • Los webhooks son una solución de API más moderna que permite una configuración más sencilla para las aplicaciones modernas
  • Se pueden configurar varios webhooks por ámbito (cuenta/grupo/usuario/recurso), donde las devoluciones de llamada debían ser únicas.
  • Los webhooks permiten la selección de los datos que se van a devolver, donde las devoluciones de llamada son una solución de “todo o nada”
  • Los metadatos transportados con un webhook se pueden configurar (Básico o Detallado)
  • Los webhooks son mucho más fáciles de crear, editar o deshabilitar según sea necesario, ya que la interfaz de usuario está totalmente bajo el control del administrador.
Nota:

Este documento se centra principalmente en la interfaz de usuario de webhooks en la aplicación web de Acrobat Sign (anteriormente Adobe Sign).

Los desarrolladores que buscan detalles de la API pueden encontrar más información aquí:

Requisitos previos

Usted debe permitir los intervalos de IP para los webhooks a través de la seguridad de la red para que el servicio funcione. 

El servicio URL de devolución de llamada heredado de REST versión 5 utiliza los mismos intervalos de IP que el servicio webhook.

Los administradores pueden iniciar sesión en Adobe Admin Console para añadir usuarios. Una vez que haya iniciado sesión, vaya al menú del administrador y desplácese hacia abajo hasta los webhooks.

Cómo se usa

Los administradores primero tendrán que tener un servicio webhook, listo para aceptar la inserción entrante desde Acrobat Sign. Hay muchas opciones en este sentido, y mientras el servicio pueda aceptar solicitudes de POST y GET, el webhook tendrá éxito.

Una vez implementado el servicio, un administrador de Acrobat Sign puede crear un nuevo webhook a partir de la interfaz de Webhook en el menú Cuenta del sitio de Acrobat Sign.

Los administradores pueden configurar el webhook para que se active para los eventos del acuerdo, formulario web (Widget) o envío en bloque (MegaSign). El recurso Plantilla de biblioteca (Documento de biblioteca) también se puede configurar mediante la API.

El ámbito del webhook puede incluir toda la cuenta o grupos individuales a través de la interfaz de administración. La API permite una mayor granularidad a través de la selección de los ámbitos USUARIO o RECURSO.

El tipo de datos que se insertan en la URL es configurable y puede incluir elementos como la información del acuerdo, del participante, del documento, etc.

Una vez configurado y guardado el webhook, Acrobat Sign insertará un nuevo objeto JSON en la dirección URL definida cada vez que se active el evento de suscripción. No se requiere ninguna manipulación continua del webhook a menos que desee cambiar los criterios del activador de eventos o la carga de JSON.

Verificación de la intención de la URL del webhook

Antes de registrar un webhook correctamente, Acrobat Sign verifica que la URL del webhook proporcionada en la solicitud de registro tenga realmente la intención de recibir notificaciones o no. Para ello, cuando Acrobat Sign recibe una nueva solicitud de registro de webhook, primero realiza una solicitud de verificación a la URL del webhook. Esta solicitud de verificación es una petición GET HTTPS enviada a la URL de webhook. Esta solicitud tiene un encabezado HTTP personalizado X-AdobeSign-ClientId. El valor de este encabezado se establece en el ID de cliente (ID de aplicación) de la aplicación de API que solicita crear o registrar el webhook. Para registrar correctamente un webhook, la URL del webhook responde a esta solicitud de verificación con un código de respuesta 2XX Y, además, PUEDE devolver el mismo valor de ID de cliente de una de las dos maneras siguientes:

  • Ya sea en un encabezado de respuesta X-AdobeSign-ClientId. En el mismo encabezado que se transfiere en la solicitud y se reproduce en la respuesta.
  • En el cuerpo de la respuesta JSON con la clave xAdobeSignClientId y su valor es el mismo ID de cliente que se envía en la solicitud.

El webhook se registrará correctamente solo en una respuesta correcta (código de respuesta 2XX) y validación del ID de cliente en el encabezado o el cuerpo de la respuesta. El propósito de esta solicitud de verificación es demostrar que la URL del webhook realmente desea recibir notificaciones en esa URL. Si escribe la dirección URL incorrecta por accidente, esta no responderá correctamente a la solicitud de verificación de la intención, y Acrobat Sign no enviará ninguna notificación a dicha dirección URL. Además, la URL del webhook también puede validar que recibiría notificaciones solo a través de los webhooks registrados por una aplicación específica. Esto se puede hacer validando el ID de cliente de la aplicación pasada en el encabezado X-AdobeSign-ClientId. Si la URL del webhook no reconoce ese ID de cliente, NO DEBE responder con el código de respuesta correcta, y Acrobat Sign se encarga que no se registre la URL como webhook.

La verificación de la llamada URL del webhook se realizará en los siguientes escenarios:

  • Registro del webhook: si esta verificación de la llamada URL del webhook falla, el webhook no se crea.
  • Actualización del webhook: INACTIVO a ACTIVO: si esta verificación de la llamada URL del webhook falla, el estado del webhook no se cambiará a ACTIVO.

Cómo responder a una notificación de webhook

Acrobat Sign realiza una verificación implícita de la intención en cada solicitud de notificación del webhook que se envía a la URL del webhook. Por lo tanto, cada solicitud HTTPS de notificación de webhook también contiene el encabezado HTTP personalizado denominado X-AdobeSign-ClientId. El valor de este encabezado es el ID de cliente (ID de aplicación) de la aplicación que creó el webhook. Consideraremos que la notificación del webhook se ha enviado correctamente si, y solo si, se devuelve una respuesta de éxito (código de respuesta 2XX) y se envía el ID de cliente en el encabezado HTTP (X-AdobeSign-ClientId) o en el cuerpo de la respuesta de JSON con una clave como xAdobeSignClientId y un valor como el mismo ID de cliente. De lo contrario, se intentará volver a entregar la notificación a la URL del webhook hasta que se agoten los reintentos.

Como se ha mencionado anteriormente, el encabezado “X-AdobeSign-ClientId” se incluye en todas las solicitudes de notificación de Sign y el valor de este encabezado (ID de cliente) se debe repetir como respuesta de dos formas:

1. Encabezado HTTP X-AdobeSign-ClientId y valor como este ID de cliente

Código JavaScript de muestra para obtener el ID de cliente, validarlo y devolverlo en el encabezado de respuesta

// Recuperar ID de cliente

var clientid = request.headers['X-ADOBESIGN-CLIENTID'];

 

//Validarlo

if (clientid ==="BGBQIIE7H253K6") //Reemplace “BGBQIIE7H253K6” por el ID de cliente de la aplicación que utiliza para crear el webhook

{

    //Devuélvalo en el encabezado de respuesta

    response.headers['X-AdobeSign-ClientId'] = clientid;

    response.status = 200;  // valor predeterminado

}

Código PHP de muestra para obtener el ID de cliente, validarlo y devolverlo en el encabezado de respuesta

<?php

// Recuperar ID de cliente

$clientid = $_SERVER['HTTP_X_ADOBESIGN_CLIENTID'];

//Validarlo

if($clientid == "BGBQIIE7H253K6") //Reemplace 'BGBQIIE7H253K6' por el ID de cliente de la aplicación que usa el webhook para su creación

{

    //Devuélvalo en el encabezado de respuesta

   header("X-AdobeSign-ClientId:$clientid");

   header("HTTP/1.1 200 OK"); // valor predeterminado

}

?>


2. Cuerpo de la respuesta de JSON con la clave xAdobeSignClientId y el valor como el mismo ID de cliente

Código JavaScript de muestra para obtener el ID de cliente, validarlo y devolverlo en el cuerpo de la respuesta

// Recuperar ID de cliente

var clientid = request.headers['X-ADOBESIGN-CLIENTID'];

 

 

//Validarlo

if (clientid ==="BGBQIIE7H253K6") //Reemplace “BGBQIIE7H253K6” por el ID de cliente de la aplicación que utiliza para crear el webhook

{

    var responseBody = {

                         "xAdobeSignClientId" : clientid // Devuelva el ID de cliente en el cuerpo

                       };

    response.headers['Content-Type'] = 'application/json';

    response.body = responseBody;

    response.status = 200;

}

Código PHP de ejemplo para obtener el ID de cliente, validarlo y devolverlo en el cuerpo de la respuesta

<?php

// Recuperar ID de cliente

$clientid = $_SERVER['HTTP_X_ADOBESIGN_CLIENTID'];

//Validarlo

if($clientid == "BGBQIIE7H253K6") //Reemplace 'BGBQIIE7H253K6' por el ID de cliente de la aplicación que usa el webhook para su creación

{

   //Devolverlo en el cuerpo de la respuesta

   header("Content-Type: application/json");

   $body = array('xAdobeSignClientId' => $clientid);

   echo json_encode($body);

   header("HTTP/1.1 200 OK"); // valor predeterminado

}

?>

Cuerpo JSON de muestra de la respuesta

{

    "xAdobeSignClientId": "BGBQIIE7H253K6"

}

Requisitos previos

Necesitará lo siguiente:

  1. Una cuenta de Microsoft con licencia para crear aplicaciones de funciones de Azure
  2. Una aplicación de funciones de Azure existente, puede crear una usando https://docs.microsoft.com/es-es/azure/azure-functions/functions-create-first-azure-function 
  3. Conocimiento básico de Javascript, para que pueda comprender y escribir el código en cualquier idioma de su elección

Pasos para crear un activador de funciones de Azure que funcione como webhook de Acrobat Sign

Para crear una función de activación de HTTP de Javascript:

1. Inicie sesión a través de su cuenta de Microsoft https://portal.azure.com/

2. Abra la aplicación de funciones de Azure que se muestra en la pestaña Aplicaciones de funciones.

Vaya a Aplicaciones de funciones en Azure

Se abrirá la lista de aplicaciones de funciones de Azure:

3. Elija la aplicación en la que desea crear esta nueva función

4. Haga clic en el botón Crear (+) para crear una nueva función de Azure

Crear una función de Azure

 

5. Seleccione Webhook + API como escenario y Javascript como idioma

6. Haga clic en Crear esta función

Se crea una nueva función que tiene la capacidad de gestionar una solicitud de API entrante.

Añadir lógica para registrar el webhook de Acrobat Sign

Antes de registrar un webhook correctamente, Acrobat Sign verifica que la dirección URL de webhook proporcionada en la solicitud de registro tenga realmente la intención de recibir notificaciones o no. Para ello, cuando Acrobat Sign recibe una nueva solicitud de registro de webhook, primero realiza una solicitud de verificación a la dirección URL de webhook. Esta solicitud de verificación es una petición GET HTTPS enviada a la dirección URL de webhook con un encabezado HTTP personalizado X-AdobeSign-ClientId. El valor de este encabezado se establece en el ID de cliente de la aplicación que solicita crear o registrar el webhook. Para registrar correctamente un webhook, la URL de webhook responde a esta solicitud de verificación con un código de respuesta 2XX Y, además, puede devolver el mismo valor de ID de cliente de una de las dos maneras siguientes.

Hay dos opciones que puede seguir:


Opción 1: Transfiera el ID de cliente a X-AdobeSign-ClientId como encabezado de respuesta

Transfiera X-AdobeSign-ClientId en el encabezado de la respuesta. Es el mismo encabezado, que se transfiere en la solicitud y debe reproducirse en la respuesta.

Reemplace el archivo Index.js con lo siguiente:

Reemplace el archivo index.js

module.exports = function (context, req) {

    var clientId = req.headers['x-adobesign-clientid'];

    // Validar que el ClientID entrante sea genuino

    if (clientId === '123XXX456') {

        context.res = {

            // status: 200, /* El valor predeterminado es 200 */ // Cualquier respuesta 2XX es aceptable

            body: "Notificación aceptada",

            headers : {

                'x-adobesign-clientid' : req.headers['x-adobesign-clientid']

            }

        };

    }

    else {

        context.res = {

            status: 400,

            body: "¡Vaya! Llamada ilegítima identificada"

        };

    }

    context.done();

};

 

Pruebe el comportamiento simulando la solicitud:

1. Haga clic en el botón de Prueba en la esquina derecha

2. Simular la solicitud ficticia

Pruebe la función

Aunque los encabezados de respuesta no se muestran arriba, pero se puede observar a través de la simulación por postman/DHC o cualquier otro servicio.


Opción 2: Transfiera el ID de cliente en el cuerpo de la respuesta con la clave xAdobeSignClientId

En el cuerpo de la respuesta de JSON con la clave de xAdobeSignClientId y su valor es el mismo ID de cliente que se envía en la solicitud.

Reemplace el archivo Index.js con lo siguiente:

Actualizar el contenido del archivo index.js

module.exports = function (context, req) {

    var clientId = req.headers['x-adobesign-clientid'];

    // Validar que el ClientID entrante sea genuino

    if (clientId === '123XXX456') {

        context.res = {

            // status: 200, /* El valor predeterminado es 200 */ // Cualquier respuesta 2XX es aceptable

            body: {

                'xAdobeSignClientId' : clientId

            },

            headers : {

                'Tipo de contenido' : 'application/json'

            }

        };

    }

    else {

        context.res = {

            status: 400,

            body: "¡Vaya! Llamada ilegítima identificada"

        };

    }

    context.done();

};

 

Pruebe el comportamiento simulando la solicitud

1. Haga clic en el botón de Prueba en la esquina derecha

2. Simular la solicitud ficticia

Pruebe la función

Tenga en cuenta también que se espera el mismo comportamiento para clientID cuando la URL de webhook recibe notificaciones del POST. 


Listo para usar

Una vez que haya verificado el comportamiento, la URL del webhook funciona según los estándares de Acrobat Sign. Puede actualizar aún más la lógica personalizada según sus requisitos.

 

Obtener la URL de función

  • Haga clic en Obtener la URL de función
Obtener la URL de función

 

Copie la URL y utilícela para crear webhooks en Acrobat Sign.

Copiar la URL de la función

Creación de la función AWS Lambda

Para crear una función AWS Lambda, inicie sesión en su AWS Management Console y seleccione el servicio AWS Lambda en la lista de servicios.

  • Haga clic en Crear una función lambda usando la opción Autor desde cero
  • En la página Configurar función introduzca el nombre de función lambdaWebhooks y seleccione Node.js 4.3 como motor de ejecución
  • Para la Función elija una función existente o cree una nueva función a partir de plantillas
    • Si ha elegido  Crear nuevo rol a partir de plantillas introduzca un nombre de función (p. ej. role-lambda) y seleccione Permisos simples de Microservicios de la lista de Plantillas de políticas
  • Haga clic en el botón Crear función
Crear una función en AWS

  • En la nueva página de la función lambda de AWS, seleccione Editar código en línea como Tipo de entrada de código, mantenga index.handler como Controlador.
  • Añadir lógica para registrar el webhook de Acrobat Sign

    Antes de registrar un webhook correctamente, Acrobat Sign verifica que la dirección URL de webhook proporcionada en la solicitud de registro tenga realmente la intención de recibir notificaciones o no. Para ello, cuando Acrobat Sign recibe una nueva solicitud de registro de webhook, primero realiza una solicitud de verificación a la dirección URL de webhook. Esta solicitud de verificación es una petición GET HTTPS enviada a la dirección URL de webhook con un encabezado HTTP personalizado X-AdobeSign-ClientId. El valor de este encabezado se establece en el ID de cliente de la aplicación que solicita crear o registrar el webhook. Para registrar correctamente un webhook, la URL de webhook responde a esta solicitud de verificación con un código de respuesta 2XX Y, además, puede devolver el mismo valor de ID de cliente de una de las dos maneras siguientes. Tenga en cuenta también que se espera el mismo comportamiento para clientID cuando la URL de webhook recibe notificaciones del POST. 

    Siga uno de los dos casos:

    Caso 1: Transfiera el ID de cliente a X-AdobeSign-ClientId como encabezado de respuesta

    •  Transfiera X-AdobeSign-ClientId en el encabezado de la respuesta. Es el mismo encabezado, que se transfiere en la solicitud y debe reproducirse en la respuesta.

      Fragmento de código
      En el archivo index.js, reemplace el fragmento de código generado automáticamente por el código siguiente:

El código JS de nodo de ejemplo para obtener el ID de cliente, validarlo y, a continuación, devolverlo en el encabezado de respuesta

exports.handler = function index(event, context, callback) {

  // Recuperar ID de cliente

  var clientid = event.headers['X-AdobeSign-ClientId'];

 

  //Validarlo

  if (clientid =="BGBQIIE7H253K6") //Reemplace 'BGBQIIE7H253K6' por el ID de cliente de la aplicación que utiliza para crear el webhook

  {

    var response = {

        statusCode: 200,

        headers: {

            "X-AdobeSign-ClientId": clientid

        }

     };

   callback(null,response);

  }

  else {

   callback("¡Vaya! llamada ilegítima");

  }

}

 

Caso 2: Transferir el ID de cliente en el cuerpo de la respuesta con la clave xAdobeSignClientId

En el cuerpo de la respuesta de JSON con la clave de xAdobeSignClientId y su valor es el mismo ID de cliente que se envía en la solicitud.

 

Fragmento de código

Reemplace el archivo Index.js con lo siguiente:

El código JS de nodo de ejemplo para obtener el ID de cliente, validarlo y, a continuación, devolverlo en el encabezado de respuesta

exports.handler = function index(event, context, callback) {

 // Recuperar ID de cliente

 var clientid = event.headers['X-AdobeSign-ClientId'];

  

 //Validarlo

 if (clientid =="BGBQIIE7H253K6") //Reemplace 'BGBQIIE7H253K6' por el ID de cliente de la aplicación que utiliza para crear el webhook

 {

   var responseBody = {

        xAdobeSignClientId : clientid

   };

     

    var response = {

        statusCode: 200,

        body: JSON.stringify(responseBody)

    };

 

   callback(null,response);

 }

 else {

   callback("¡Vaya! llamada ilegítima");

  }

}

Actualizar el contenido del archivo index.js

  • Guarde la función. Se crea la función lambda y estamos casi listos para usarla en un webhook en tiempo real.

 

Configuración de AWS API Gateway

Para que esta lambda sea accesible públicamente a través de un método HTTP, necesitamos configurar AWS API Gateway usando nuestra función (creada anteriormente) como back-end para la API.

En AWS Management Console, seleccione la API Gateway en los servicios de AWS y haga clic en el botón Crear API

Configurar la puerta de enlace de API

  • En la página Crear nueva API seleccione Nueva API e introduzca webhooks como el Nombre de API.
  • Haga clic en el botón Crear API
  • Seleccione la lista desplegable Acciones y seleccione la opción Crear recurso
  • Compruebe la opción Configurar como recurso proxy y escriba validar como el Nombre del recurso y {proxy+} en la Ruta de recurso
  • Deje la opción Activar API Gateway CORS y haga clic en el botón Crear recurso
  • Guarde el Proxy de función lambda seleccionado como Tipo de integración y seleccione el área geográfica donde ha creado su función lambda en la lista desplegable Región de lambda (probablemente sea la misma región donde está creando la puerta de enlace de API).
  • Entre validar como la Función lambda y haga clic en el botón Guardar
  • En la ventana emergente Agregar permiso a la función lambda seleccione OK

Si todos los pasos anteriores se ejecutan correctamente, verá algo como esto:

Método configurado

Implementación de API

El siguiente paso es implementar esta API para que esté lista para usarse.

  • En el desplegable Acciones seleccione Implementar API
  • Seleccionar [Nueva fase] en la Fase de implementación e introduzca prod (o algo que desee para identificar esta etapa) en el Nombre de fase
  • Haga clic en el botón Implementar.

La API ya está lista para usarse y puede encontrar la URL de invocación en el cuadro azul, como se muestra a continuación:

Implementación de la API

Tome nota de esta URL, ya que tendrá que introducirla como su URL de webhook en tiempo real.

Listo para usar

Ya está hecho. Utilice esta URL anterior con "/{nodeJSfunctionName}"POST /webhooks.  Una vez que haya verificado el comportamiento, la URL del webhook funciona según los
estándares de Acrobat Sign. Puede actualizar o añadir la lógica personalizada según sus necesidades.

Cómo activar o desactivar

El acceso a la función Webhooks está habilitado de forma predeterminada para las cuentas de nivel empresarial.

Los administradores del grupo pueden crear o controlar los Webhooks que solo funcionan dentro de su grupo.

El acceso a la página Webhooks se encuentra en el carril izquierdo del menú Administración.

Vaya a la pestaña Webhooks

Limitación de velocidad basada en accesos simultáneos

Los eventos de creación y notificación de Webhook (y devolución de llamada) están limitados en el número de notificaciones simultáneas que se envían activamente al cliente desde el sistema Acrobat Sign. Este límite se aplica a la cuenta, para incluir todos los grupos dentro de la cuenta.
Este tipo de limitación de tarifas impide que una cuenta mal diseñada consuma una cantidad desproporcionada de recursos del servidor, lo que repercute negativamente en todos los demás clientes de ese entorno de servidores.

El número de eventos simultáneos por cuenta se ha calculado para garantizar que las cuentas con webhooks de buen comportamiento reciban sus notificaciones en el menor tiempo posible y rara vez se encuentren en una situación en la que las notificaciones se retrasen debido a demasiadas solicitudes. Los umbrales actuales son:

Acción
(Evento)

Máximos
eventos
simultáneos

Descripción

Creación de webhooks

10

Se permite un máximo de 10 solicitudes de creación de webhook simultáneas por cuenta.
Las solicitudes que superen este límite generarán un código de respuesta 429 TOO_MANY_REQUESTS.
 

Notificación de webhook/devolución de llamada

30

Se permite un máximo de 30 notificaciones simultáneas de webhook y de devolución de llamada por cuenta.
Las notificaciones que superen este límite se volverán a intentar según un retroceso exponencial hasta que se entreguen.

Prácticas recomendadas

  • Suscribirse a eventos específicos necesarios para limitar el número de solicitudes HTTPS al servidor: cuanto más específica pueda hacer sus webhooks, menos volumen tendrá que seleccionar.
  • Ser resistente a duplicados: si tiene más de una aplicación que comparte la misma URL de webhook y el mismo usuario asignado a cada aplicación, se enviará el mismo evento a su webhook varias veces (una vez por aplicación). En algunos casos, su webhook puede recibir eventos duplicados. La aplicación webhook debe tolerar esto y deduplicarse por ID de evento.
  • Responda siempre a los webhooks rápidamente: la aplicación solo tiene cinco segundos para responder a las solicitudes de webhook. En el caso de la solicitud de verificación, esto no suele ser un problema, ya que la aplicación no necesita realizar ningún trabajo real para responder. Sin embargo, para las solicitudes de notificación, la aplicación suele hacer algo que lleva tiempo en respuesta a la solicitud. Se recomienda trabajar en un hilo independiente o utilizar una cola de forma asincrónica para garantizar que pueda responder en cinco segundos.
  • Administrar simultaneidad: cuando un usuario realiza una serie de cambios en sucesión rápida, es probable que su aplicación reciba varias notificaciones para el mismo usuario aproximadamente al mismo tiempo. Si no tiene cuidado con la administración de la concurrencia, la aplicación puede terminar procesando los mismos cambios para el mismo usuario más de una vez. Para poder utilizar los webhooks de Acrobat Sign, es necesario entender claramente el uso de la información. Asegúrese de hacer preguntas como: 
    • ¿Qué datos desea devolver en la carga útil? 
    • ¿Quién accederá a esta información? 
    • ¿Qué decisiones o creación de informes se generarán?
  • Recomendaciones para la recepción de documentos firmados: existen varios factores que se deben tener en cuenta a la hora de determinar cómo recibir un PDF firmado de Acrobat Sign en el sistema de gestión de documentos. 

Si bien es perfectamente aceptable seleccionar el Documento firmado del acuerdo al crear un webhook, puede que le interese utilizar la API de Acrobat Sign para recuperar los documentos cuando se reciba un evento de activación (como el estado Completado del acuerdo).

Cuestiones importantes

Limitación de tamaño de JSON

El tamaño de la carga útil de JSON está limitado a 10 MB.

Si un evento genera una carga más grande, se activará un webhook, pero se eliminarán los atributos de parámetro condicional, si están en la solicitud, para reducir el tamaño de la carga. 

"ConditionalParametersTrimmed " se devolverá en la respuesta cuando esto ocurra para informar al cliente de que la información  conditionalParameters  se ha eliminado.

conditionalParametersTrimmed es un objeto de matriz que contiene la información sobre las claves que se han recortado.

El truncamiento se realizará en el orden siguiente:

  • includeSignedDocuments
  • includeParticipantsInfo
  • includeDocumentsInfo
  • includeDetailedInfo

Los documentos firmados se truncarán primero, seguidos de la información del participante, la información del documento y, por último, la información detallada.

Esto puede ocurrir, por ejemplo, en un evento de finalización de acuerdo si incluye también un documento firmado (codificado en base 64) o en un acuerdo con varios campos de formulario

Notificaciones de webhook

Los webhooks de Acrobat Sign envían notificaciones al remitente del acuerdo y a cualquier webhook configurado dentro del grupo desde el que se envió el acuerdo. Los webhooks de las cuentas reciben todos los eventos.

Remitente: Usuario A | Firmante: Usuario B | Usuario con el que se comparte: Usuario C

El usuario A y el usuario B están en cuentas diferentes

El usuario A y el usuario C están en cuentas diferentes

Caso de uso

Notificación?

Comentarios o notas

La cuenta del usuario A tiene webhook de nivel CUENTA (creado por el usuario A o el administrador de la cuenta).

Un webhook de nivel CUENTA recibe una notificación de todos los eventos activados en esa cuenta.

La cuenta del usuario A tiene webhook de nivel GRUPO (creado por el usuario A o el administrador de la cuenta/grupo).

Suposición: El usuario A y el administrador de grupo están en el mismo grupo.

Un webhook de nivel GRUPO recibe una notificación de todos los eventos activados en ese grupo.

El usuario A tiene webhook de nivel USUARIO.

Como remitente, se activa el webhook de nivel USUARIO del usuario A

El usuario A tiene webhook de nivel RECURSO (para el acuerdo enviado anteriormente).

 
     

La cuenta del usuario B tiene webhook de nivel CUENTA (creado por el usuario B o el administrador de la cuenta).

No

El Webhook de nivel CUENTA del usuario B se considera un webhook del firmante.

La cuenta del usuario B tiene webhook de nivel GRUPO (creado por el usuario B o el administrador de la cuenta o grupo).

Suposición: El usuario B y el administrador de grupo están en el mismo grupo.

No

El webhook de nivel GRUPO del usuario B se considera un webhook del firmante.

El usuario B tiene webhook de nivel USUARIO.

No

El webhook de nivel USUARIO del usuario B se considera un webhook del firmante.

     

La cuenta del usuario C tiene webhook de nivel CUENTA (creado por el usuario C o el administrador de la cuenta).

No

EL webhook de nivel CUENTA del usuario C se considera un webhook que no es el originador.

La cuenta del usuario C tiene webhook de nivel GRUPO (creado por el usuario C o el administrador de la cuenta/grupo).

Suposición: El usuario C y el administrador de grupo están en el mismo grupo.

No

El webhook de nivel GRUPO del usuario C se considera un webhook que no es originador.

El usuario C tiene webhook de nivel USUARIO.

No

El webhook de nivel USUARIO del usuario C se considera un webhook que no es originador.

Remitente: Usuario A | Firmante: Usuario B | Usuario con el que se comparte: Usuario C

El usuario A, el usuario B y el usuario C están en la misma cuenta

Caso de uso

Notificación?

Notas

La cuenta del usuario A tiene webhook de nivel CUENTA (creado por el usuario A o el administrador de la cuenta).

Los webhooks de nivel CUENTA notifican los eventos activados por la cuenta.

La cuenta del usuario A tiene webhook de nivel GRUPO (creado por el usuario A o el administrador de la cuenta/grupo).

Suposición: El usuario A y el administrador de grupo pertenecen al mismo grupo.

Los webhooks de nivel GRUPO notifican los eventos activados por los usuarios de su grupo.

El usuario A tiene webhook de nivel USUARIO.

Como remitente, se activa el webhook de nivel Usuario del usuario A

El usuario A tiene webhook de nivel RECURSO (para el acuerdo enviado anterior).

 
     

La cuenta del usuario B tiene webhook de nivel CUENTA (creado por el usuario B o el administrador de la cuenta).

Dado que el Usuario A y el Usuario B se encuentran en la misma cuenta, el webhook de nivel CUENTA recibe una notificación de todos los eventos activados en esa cuenta.

La cuenta del usuario B tiene webhook de nivel GRUPO (creado por el usuario B o el administrador de la cuenta o grupo).

Suposición: El usuario A, el usuario B y el administrador de grupo pertenecen al mismo grupo.

Dado que el Usuario A y el Usuario B se encuentran en el mismo grupo, el webhook de nivel GRUPO recibe una notificación de todos los eventos activados en ese grupo.

La cuenta del usuario B tiene webhook de nivel GRUPO (creado por el usuario B o el administrador de la cuenta o grupo).

Suposición: El usuario A y el usuario B están en grupos diferentes.

No

El webhook de nivel GRUPO del usuario B se considera un webhook del firmante.

El Webhook del usuario A (RECURSO/USUARIO/GRUPO/CUENTA) se activará.

El usuario B tiene webhook de nivel USUARIO.

No

Como destinatario, no se activará el webhook de nivel USUARIO del usuario B.

     

La cuenta del usuario C tiene webhook de nivel CUENTA (creado por el usuario C o el administrador de la cuenta).

Dado que el Usuario A y el Usuario C se encuentran en la misma cuenta, el webhook de nivel CUENTA recibe una notificación de todos los eventos activados en esa cuenta.

La cuenta del usuario C tiene webhook de nivel GRUPO (creado por el usuario C o el administrador de la cuenta/grupo).

Suposición: El usuario A, el usuario C y el administrador de grupo pertenecen al mismo grupo.

Dado que el Usuario A y el Usuario C se encuentran en el mismo grupo, el webhook de nivel GRUPO recibe una notificación de todos los eventos activados en ese grupo.

La cuenta del usuario C tiene webhook de nivel GRUPO (creado por el usuario C o el administrador de la cuenta/grupo).

Suposición: El usuario A y el usuario C están en grupos diferentes.

No

El webhook de nivel GRUPO del usuario C se considera un webhook que no es originador.

El Webhook del usuario A (RECURSO/USUARIO/GRUPO/CUENTA) se activará.

El usuario C tiene webhook de nivel USUARIO.

No

El webhook de nivel USUARIO del usuario C se considera un webhook que no es originador.

Reintentar cuando el servicio de escucha esté inactivo

Si la dirección URL de destino de webhook está desactivada por cualquier motivo, Acrobat Sign pone el JSON en cola y vuelve a intentar la inclusión en un ciclo progresivo durante 72 horas.

Los eventos no entregados se conservan en una cola de reintentos y durante las siguientes 72 horas se intenta enviar las notificaciones en el orden en que se produjeron.

La estrategia para reintentar la entrega de notificaciones consiste en duplicar el tiempo entre intentos, comenzando con un intervalo de 1 minuto que aumenta a cada 12 horas, lo que se traduce en 15 reintentos en un lapso de 72 horas.

Si el receptor webhook no responde en un plazo de 72 horas y no se han realizado entregas de notificación correctas en los últimos siete días, el webhook se desactivará. No se enviarán notificaciones a esta dirección URL hasta que se active de nuevo el webhook.

Se perderán todas las notificaciones entre el momento en que se desactive el webhook y se active de nuevo posteriormente.

 Adobe

Obtén ayuda de forma más rápida y sencilla

¿Nuevo usuario?

Adobe MAX 2024

Adobe MAX

The Creativity Conference

Del 14 al 16 de octubre en Miami Beach y en línea

Adobe MAX 2024

Adobe MAX

The Creativity Conference

Del 14 al 16 de octubre en Miami Beach y en línea