Desarrolladores
Configura un webhook
Recibe una solicitud HTTPS POST de SignQuick cuando ocurre un evento de un documento.
En SignQuick Pro y Equipo, agrega un webhook en Configuración y luego Integraciones, y recibe un POST HTTPS firmado con cada evento.
¿Quién puede usar esta función?
- Planes
- Pro, con hasta 3 webhooks, y Equipo, con hasta 10. Si llegas al límite, no puedes usar Agregar webhook. En Gratis, Integraciones muestra Los webhooks requieren un plan de pago.
- Quién puede hacerlo
- Los Propietarios, los Administradores y los miembros con el permiso Administrar integraciones.
- Antes de empezar
- Un endpoint HTTPS que acepte solicitudes POST.
Agrega un webhook
- Paso 1: En la barra lateral, selecciona Configuración, el ícono de engranaje junto a tu nombre.
- Paso 2: Selecciona Integraciones.
- Paso 3: Selecciona Agregar webhook.
- Paso 4: Ingresa la URL del endpoint (HTTPS obligatorio).
- Paso 5: Agrega una Descripción (opcional) para distinguir tus webhooks.
- Paso 6: En Eventos, marca los eventos que quieras, o usa Seleccionar todo.
- Paso 7: Selecciona Crear webhook.
- Paso 8: Copia el secreto del aviso Secreto de firma del webhook — ¡cópialo ahora!.
- Paso 9: Selecciona Enviar evento de prueba en la tarjeta del webhook.
Resultado: SignQuick muestra Prueba exitosa con el código de estado de tu endpoint. Los eventos de prueba no aparecen en Historial de intentos de entrega.
Verifica cada entrega
Cada entrega trae un encabezado X-SignQuick-Signature con la forma sha256=<hex>. Es un código de autenticación de mensajes basado en hash (HMAC). El encabezado X-SignQuick-Event dice qué evento es.
- Paso 1: Calcula el HMAC SHA-256 del cuerpo crudo de la solicitud con tu secreto.
- Paso 2: Pon sha256= antes del resultado en hex.
- Paso 3: Compara el resultado con el del encabezado, en tiempo constante.
- Paso 4: Guarda la entrega ya verificada y luego responde con un estado 2xx.
- Paso 5: Ignora un X-SignQuick-Delivery-ID que ya procesaste.
Resultado: En Historial de intentos de entrega, la entrega dice Intento exitoso.
Preguntas frecuentes
¿Qué eventos puedo recibir?
Puedes recibir un evento cuando un documento se crea, se envía, se ve, se firma, se completa, se rechaza, se anula o expira. También hay uno para cuando termina un envío masivo. Los eliges para cada webhook en Eventos.
¿Qué pasa cuando fallan las entregas?
Si una entrega falla, SignQuick la vuelve a intentar unas pocas veces. Si falla muchas veces seguidas, el webhook se deshabilita. Si una entrega agota sus intentos, puedes volver a enviarla una vez desde Revisar reintento y recuperación.