Guía del usuario Cancelar

Configurar un webhook nuevo

 

Guía de Adobe Acrobat Sign

Novedades

Introducción

Administrar

Enviar, firmar y administrar acuerdos

Capacidades y flujos de trabajo de acuerdos avanzados

Integrar con otros productos

Acrobat Sign Desarrolladores

Soporte y solución de problemas

Opciones de configuración

La configuración del webhook requiere que se definan cinco elementos:

  • Nombre: se sugiere un nombre intuitivo que otros administradores puedan entender fácilmente.
  • Ámbito: ¿qué anchura de red cubre 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 dirección URL de destino en la que Acrobat Sign ha insertado la carga de JSON.
  • Eventos: el activador que hace que Acrobat Sign cree el JSON y lo inserte en la URL.
    • Cada evento crea una carga diferente relevante para el evento de activación.
    • Varios Eventos se pueden incluir en un webhook.
  • Parámetros de notificación: los Parámetros de notificación identifican la carga del Evento JSON, lo que le permite seleccionar solo las secciones del Evento que son importantes para este webhook (y, por lo tanto, reducen los datos innecesarios en la URL).

Cuando el webhook esté completamente definido, haga clic en Guardar y el nuevo webhook empezará a reaccionar para activar los eventos inmediatamente. 

Nota:

Configure su URL de webhook para responder a las solicitudes de verificación y notificación de webhook según el protocolo de verificación explicado anteriormente. El ID de cliente (ID de aplicación) que se enviará a webhooks creados desde la aplicación web de Acrobat Sign será - UB7E5BXCXY

Configurar el webhook

Ámbitos

  • Cuenta: todos los eventos de suscripción que se producen en la cuenta activan la inserción.
    • Los administradores de cuentas tienen autoridad para ver todos los webhooks definidos para la cuenta y todos los grupos de esa cuenta.
  • Grupo: todos los eventos suscritos que se producen en ese grupo activan la inserción. NOTA: los webhooks de ámbito de grupo solo existen para ese grupo.
    • Los administradores de grupo solo verán los webhooks dedicados a su grupo. No pueden ver los webhooks o webhooks de nivel de cuenta enlazados a otros grupos.
    • Las cuentas que tengan habilitadas los Usuarios en varios grupos verán la opción para establecer el grupo al que se debe aplicar el ámbito.
  • Cuenta de usuario: todos los eventos de suscripción de una cuenta de usuario activan la inserción. Los webhooks de nivel de usuario solo se pueden crear mediante API.
  • Webhook de nivel de recurso: se creará para un recurso específico. Los eventos específicos de este recurso se insertarán en la URL del webhook. Los webhooks de nivel de recurso solo se pueden crear mediante API.

URL

Una URL de webhook es un servidor que escucha los mensajes de notificación de POST HTTPS entrantes que se activan cuando se producen eventos.

Necesita esta dirección URL para suscribirse a su webhook para eventos.

  • El cliente debe incluir una dirección URL HTTPS a la que Acrobat Sign pueda ser POST. Esta URL debe estar disponible en la red pública.  
    • Por ejemplo, los URI 127.0.0.1 y localhost no funcionarán.
    • El URL de punto final debe estar escuchando en el puerto 443 u 8443 (lo decide el cliente al definir la URL de devolución de llamada).
  • Asegúrese de que el webhook admite solicitudes de POST para notificaciones de eventos entrantes y solicitudes de GET para la solicitud de verificación.
  • Un cortafuegos no debe bloquear la URL.

Eventos

A continuación se muestran los eventos que pueden desencadenar una inclusión en la URL del webhook, agrupados por objeto y enumerados en el orden encontrado en la IU.

El valor de la izquierda es el valor que verá en la IU de Acrobat Sign. El valor de la derecha es el nombre del webhook en la API.

Para obtener información detallada sobre los webhooks y sus cargas, consulte la Guía para desarrolladores de Acrobat Sign.

Acuerdos:

Elemento IU Nombre de la webhook
Acuerdo de todos los eventos AGREEMENT_ALL
Acuerdo creado AGREEMENT_CREATED
Acuerdo enviado AGREEMENT_ACTION_REQUESTED
Participante en el acuerdo completado AGREEMENT_ACTION_COMPLETED
Flujo de trabajo del acuerdo completado AGREEMENT_WORKFLOW_COMPLETED
Acuerdo caducado AGREEMENT_EXPIRED
Acuerdo eliminado AGREEMENT_DOCUMENTS_DELETED
Acuerdo cancelado AGREEMENT_RECALLED
Acuerdo rechazado AGREEMENT_REJECTED
Acuerdo compartido AGREEMENT_SHARED
Acuerdo no compartido AGREEMENT_UNSHARE
Acuerdo no compartido automático AGREEMENT_UNSHARE_AUTO
Acuerdo delegado AGREEMENT_ACTION_DELEGATED
Participante en el acuerdo sustituido AGREEMENT_ACTION_REPLACED_SIGNER
Acuerdo modificado AGREEMENT_MODIFIED
Modificación del acuerdo confirmado AGREEMENT_USER_ACK_AGREEMENT_MODIFIED
Acuerdo del correo electrónico visto AGREEMENT_EMAIL_VIEWED
Acuerdo del correo electrónico devuelto AGREEMENT_EMAIL_BOUNCED
Documento de acuerdo visualizado AGREEMENT_DOCUMENTS_VIEWED
Documento de acuerdo visualizado cuando se ha aplicado una contraseña para ver el documento AGREEMENT_DOCUMENTS_VIEWED_PASSWORD_PROTECTED
Error al crear el acuerdo AGREEMENT_AUTO_CANCELLED_CONVERSION_PROBLEM
Evento de publicación de acuerdo sincronizado sin conexión AGREEMENT_OFFLINE_SYNC
Acuerdo protegido AGREEMENT_VAULTED
Identidad social del participante en el acuerdo autenticado AGREEMENT_WEB_IDENTITY_AUTHENTICATED
Participante en el acuerdo autenticado mediante autenticación KBA AGREEMENT_KBA_AUTHENTICATED
Se ha autenticado el OTP de correo electrónico del participante del contrato
AGREEMENT_EMAIL_OTP_AUTHENTICATED
Caducidad del acuerdo actualizada AGREEMENT_EXPIRATION_UPDATED
Se ha enviado un recordatorio del acuerdo AGREEMENT_REMINDER_SENT
El firmante ha modificado el nombre del firmante del acuerdo AGREEMENT_SIGNER_NAME_CHANGED_BY_SIGNER
Recordatorio de contrato iniciado AGREEMENT_REMINDER_INITIATED
   
Los webhooks del acuerdo solo están disponibles mediante una API
Elemento IU Nombre de la webhook
N/A
AGREEMENT_READY_TO_NOTARIZE
N/A
AGREEMENT_READY_TO_VAULT

 

Enviar en bloque:

Elemento IU Nombre de la webhook
Enviar en lote de todos los eventos MEGASIGN_ALL
Enviar en lote creado
MEGASIGN_CREATED
Enviar en lote compartido
MEGASIGN_SHARED
Enviar en lote reclamado
MEGASIGN_RECALLED
Recordatorio de envío por lote enviado MEGASIGN_REMINDER_SENT
Recordatorio de envío por lote iniciado MEGASIGN_REMINDER_INITIATED

 

Formularios web:

Elemento IU Nombre de la webhook
Todos los eventos del formulario web WIDGET_ALL
Formulario web creado
WIDGET_CREATED
Formulario web habilitado
WIDGET_ENABLED
Formulario web deshabilitado
WIDGET_DISABLED
Formulario web modificado
WIDGET_MODIFIED
Formulario web compartido
WIDGET_SHARED
Error al crear el formulario web
WIDGET_AUTO_CANCELLED_CONVERSION_PROBLEM

 

Plantillas de biblioteca (solo API):

Elemento IU Nombre de la webhook
N/A LIBRARY_DOCUMENT_ALL
N/A LIBRARY_DOCUMENT_CREATED
N/A LIBRARY_DOCUMENT_AUTO_CANCELLED_CONVERSION_PROBLEM
N/A LIBRARY_DOCUMENT_MODIFIED

 

Parámetros de notificación

Los parámetros de notificación permiten personalizar la carga de JSON a elementos específicos del evento.

Por ejemplo, en un evento Participante en el acuerdo sustituido, puede que solo desee la Información del acuerdo y la Información del participante, dejando fuera la Información del documento, y reduciendo el volumen total del JSON enviado en la URL del webhook.

 

  • Acuerdo
    • Información del acuerdo: información detallada del acuerdo basada en el estado del acuerdo en el momento del evento desencadenante.
    • Información del documento del acuerdo: incluye cualquier información de documento generada como resultado del evento.
    • Información del participante del acuerdo: incluye la información de los participantes como resultado del evento.
    • Documento firmado del acuerdo: proporciona el PDF firmado. 
      • Aplicable al Flujo de trabajo del acuerdo completado y a todos los eventos del Acuerdo.
  • Enviar en bloque
    • Información de Enviar en bloque: información detallada acerca el objeto Enviar en bloque que desencadenó el evento.
  • Formulario web
    • Información del widget: información detallada acerca del formulario web que desencadenó el evento.
    • Información del documento del widget: la información del documento asociada a la plantilla del formulario web.
    • Información del participante del widget: información sobre los participantes definidos en la plantilla del formulario web.

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

¿Nuevo usuario?