Webhooks en tiempo real para actividad en PDF

¿Qué eventos puede enviar un webhook?

Un PDF compartido genera momentos en los que quieres actuar mientras aún están sucediendo - un prospecto que abre la propuesta, un lead que completa el formulario de captación, un enlace de un solo uso que se autodestruye. Cada endpoint se suscribe exactamente a los eventos que le importan:

• Visualizado. Un lector abrió el documento. Se dispara en cada visita y lleva el archivo, la fuente de la visita y la identidad del lector que tu plan reporta - lo suficiente para que un CRM registre quién regresó.
• Descargado. Una copia salió del edificio. El evento indica qué documento y qué lector se la llevó.
• Formulario completado. Un lector superó la barrera de correo electrónico o el formulario de captación de leads. La carga útil lleva los campos capturados, listos para enviarse directamente a tu CRM mientras el lead aún está leyendo. La única entrega exclusiva de Pro - lleva datos de leads, así que se envía mientras la cuenta está en Pro.
• Comentario añadido. Un lector dejó comentarios en el documento - privados o públicos - para que la persona indicada pueda responder mientras el lector aún está en la página.
• Recepción confirmada. Un lector marcó el documento como recibido. Prueba de entrega, enviada a donde sea que viva tu registro de auditoría.
• Enlace consumido. Un enlace autodestructivo agotó su presupuesto de visualizaciones y se eliminó solo - el último evento que un enlace llega a enviar. Tu registro de lectura sobrevive; el webhook te indica el momento exacto en que el documento desapareció.

Verificar la firma

Cada entrega incluye un encabezado de firma en el mismo estilo t/v1 que usa Stripe: una marca de tiempo Unix y un resumen hexadecimal, separados por comas. El resumen es un HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo sin procesar de la solicitud, con la clave del secreto de firma del endpoint que la recibió.

Para verificar: lee la marca de tiempo y la firma del encabezado, recalcula el HMAC-SHA256 sobre marca-de-tiempo-punto-cuerpo con tu secreto y compara tu resumen con v1 usando una comparación de tiempo constante. Rechaza cualquier cosa cuya marca de tiempo sea anterior a tu tolerancia - cinco minutos es lo habitual - y las entregas falsificadas o reproducidas nunca pasarán de la puerta de entrada.

El secreto de firma se genera por endpoint y se muestra exactamente una vez, al crearlo. Guárdalo como una contraseña; si se filtra o se pierde, rota el endpoint y se generará un nuevo secreto.

Entrega, reintentos y mantenimiento

Una entrega es un POST a tu endpoint HTTPS con un cuerpo JSON; cualquier respuesta 2xx cuenta como recibida. Cualquier otra cosa - un tiempo de espera agotado, un 500, una conexión perdida - se reintenta automáticamente con espera exponencial creciente, así que un despliegue o un fallo puntual de tu lado no te cuesta nada. El evento llega cuando vuelves a estar disponible.

Un endpoint que falla en cada reintento durante un periodo prolongado se desactiva automáticamente, para que no siga absorbiendo eventos en el vacío - su estado se muestra en Configuración de la Cuenta y puedes reactivarlo una vez que tu lado esté arreglado. Cada cuenta puede registrar hasta 25 endpoints, cada uno con su propio secreto, su propia selección de eventos y su propio formato de carga útil.

Notificaciones en Slack en tres pasos

El soporte de Slack se ofrece como un formato de webhook, no como una app de Slack - no hay nada que instalar desde el directorio de aplicaciones ni nada que un administrador del workspace tenga que aprobar.

1. Crea un webhook entrante de Slack. En Slack, añade un Webhook Entrante al canal donde quieres recibir notificaciones. Slack te da una URL única para ese canal.
2. Pega la URL en EveryPage. Añádela como endpoint de webhook en Configuración de la Cuenta, igual que harías con cualquier otra URL de endpoint.
3. Elige el formato Slack. Elige Slack como formato de carga útil y selecciona tus eventos. A partir de entonces, una visualización en tu propuesta se convierte en un mensaje con formato Block Kit en el canal, segundos después.

¿Prefieres sin código? Usa Zapier

Si prefieres no ejecutar ningún endpoint receptor, la integración con Zapier conecta EveryPage con más de 7.000 apps sin código. Consulta según una programación en lugar de enviar en tiempo real, algo que funciona bien para la mayoría de los flujos de notificación y registro.

Los webhooks son el extremo en tiempo real y de nivel desarrollador del mismo espectro: entrega push, cargas útiles firmadas y tu propio código decidiendo qué sucede a continuación. Explora todas las integraciones de EveryPage para todo lo demás.