Configure webhooks en Apropos
Envíe los eventos del espacio de trabajo de Apropos — propuestas firmadas, aceptadas o con cambios solicitados, además de clientes y artículos del catálogo recién creados — a una URL que usted controle. Solo los administradores del espacio de trabajo pueden crear y revocar webhooks, y la URL receptora debe estar disponible públicamente mediante HTTPS.
Crear un webhook
Cree un webhook desde Configuración > Webhooks para comenzar a recibir eventos. Necesita un endpoint HTTPS disponible públicamente que acepte solicitudes POST.
Abra Configuración y seleccione la pestaña Webhooks.
Haga clic en Añadir webhook.
Introduzca la URL que recibirá los eventos. Debe ser una URL HTTPS válida; Apropos rechaza destinos localhost, de loopback, de metadatos link-local y con la extensión .local.
Seleccione los eventos que este webhook debe recibir. proposal.signed está seleccionado de forma predeterminada; las opciones son proposal.signed, proposal.accepted, proposal.changes_requested, customer.created y item.created.
Copie el secreto de firma cuando se cree; la interfaz lo oculta y ofrece la opción Copiar secreto de firma. No hay forma de regenerarlo posteriormente, así que guárdelo en un lugar donde su servicio pueda utilizarlo para verificar las solicitudes entrantes.
Verificar las notificaciones entrantes
Cada entrega está firmada para que pueda confirmar que proviene de Apropos. Cada POST incluye los encabezados X-Apropos-Signature, X-Apropos-Timestamp, X-Apropos-Event y X-Apropos-Delivery, y la firma es un hash HMAC-SHA256 de la marca de tiempo y el cuerpo JSON que utiliza su secreto de firma. El cuerpo contiene los campos públicos del recurso del evento: los eventos de propuestas contienen los campos públicos de la propuesta, customer.created contiene los del cliente y item.created contiene los del artículo del catálogo, sin ninguna envoltura adicional.
Revocar un webhook
Revoque un webhook cuando el servicio conectado ya no necesite los eventos. Las filas revocadas permanecen en la lista con la marca Revocado. La entrega es asíncrona y no hay ningún botón de prueba, historial de entregas ni reintento manual en Configuración; Apropos reintenta automáticamente las entregas fallidas hasta seis veces, con intervalos cada vez mayores.