¿Cómo crear webhooks en Papermark?

¿Necesitas activar automatizaciones cuando ocurre algo en Papermark? Con los webhooks puedes enviar eventos como link.viewed o document.created a cualquier servicio externo en tiempo real.

Los webhooks están disponibles en el plan Business (o durante tu prueba gratuita). Debes ser Propietario del espacio de trabajo o Administrador para gestionarlos.

Antes de empezar

• Decide dónde recibirás los eventos (por ejemplo, Slack, Zapier, endpoint personalizado).
• Asegúrate de que el destino pueda aceptar solicitudes POST con cuerpos JSON.
• Genera o ten acceso a tu URL receptora.

Paso a paso

1. Abre la configuración – Haz clic en el icono de Configuración en la barra lateral izquierda, luego elige Webhooks en el menú.

2. Crea un webhook – Presiona Crear webhook en la esquina superior derecha.

3. Nómbralo – Introduce un nombre descriptivo como Alertas de Slack (mín. 3 caracteres).
4. Pega tu URL de endpoint – Aquí es donde Papermark enviará las solicitudes POST.
5. Copia el secreto – Se genera automáticamente un secreto de firma único. Guárdalo para poder verificar las firmas.
6. Elige los disparadores – Selecciona uno o más eventos para enviar. Puedes combinar disparadores de múltiples categorías:
   • Nivel de equipo – document.created, document.updated, document.deleted, dataroom.created
   • Nivel de documento – link.created, link.updated
   • Nivel de enlace – link.viewed, link.downloaded

7. Guarda el webhook – Haz clic en Crear. Verás el nuevo webhook en la lista con su estado.
8. Prueba la entrega – Realiza una acción que coincida con uno de tus disparadores y verifica tu endpoint o registro de entregas.

Verificación de firmas

Cada solicitud incluye un encabezado X-Papermark-Signature que contiene un hash HMAC-SHA-256 de la carga útil. Haz un hash del JSON sin procesar con tu secreto guardado y compara el valor hexadecimal para asegurarte de que la llamada realmente proviene de Papermark.

X-Papermark-Signature: 3a1d5f…

Gestión de webhooks

• Editar – Haz clic en un webhook de la lista para cambiar el nombre, añadir/eliminar disparadores o cambiar la URL.
• Ver registros – Abre un webhook y cambia a Registro de entregas para ver cada intento y código de respuesta.
• Eliminar – Utiliza el botón Eliminar dentro de la página de detalles del webhook para detener las entregas.

Consejos

• Mantén tu endpoint altamente disponible; Papermark reintenta las entregas fallidas durante 24 horas.
• Utiliza colas (por ejemplo, AWS SQS, RabbitMQ) para desacoplar el procesamiento de la recepción.
• Filtra eventos por el campo event para dirigirlos a diferentes manejadores.

¿Necesitas ayuda? Envía un correo electrónico a support@papermark.com o utiliza el chat en la aplicación – ¡estaremos encantados de ayudarte!