Integraciones
Webhooks
Algunos proveedores comunican los eventos al momento en lugar de esperar a la siguiente sincronización. Para ello introduces en ellos una dirección del webhook de VentionDesk. Cada URL pertenece a exactamente una conexión de tu espacio de trabajo.
Dónde encontrar la URL
Operaciones › Fuentes, en la conexión «Mostrar la dirección del webhook» (solo el propietario). La API devuelve la misma URL en GET /v1/integrations/:id/webhook. Se mantiene igual aunque vuelvas a conectar la conexión.
| Proveedor | URL | Comprobación |
|---|---|---|
| Stripe | https://api.ventiondesk.com/webhooks/stripe/<espacio> | firma en la cabecera Stripe-Signature |
| Sentry | https://api.ventiondesk.com/webhooks/errors/sentry/<conexión> | firma en la cabecera Sentry-Hook-Signature |
| Bugsnag | https://api.ventiondesk.com/webhooks/errors/bugsnag/<conexión>/<secreto> | secreto en la URL |
| Rollbar | https://api.ventiondesk.com/webhooks/errors/rollbar/<conexión>/<secreto> | secreto en la URL |
VentionDesk rellena los marcadores entre ángulos — copia siempre la URL desde «Mostrar la dirección del webhook» y no la montes tú.
Stripe
Créalo en Stripe › Developers › Webhooks › «Add endpoint» con exactamente estos eventos:
checkout.session.completedcheckout.session.async_payment_succeededcheckout.session.async_payment_failedcharge.refunded
Después copia el secreto de firma del endpoint (whsec_…) y vuelve a guardar con él la conexión de Stripe en VentionDesk. Solo entonces aparece el enlace de pago en el correo y en el documento de la factura — sin el webhook, un pago llegaría sin que VentionDesk lo registrara.
VentionDesk comprueba la firma (HMAC-SHA256 sobre la marca de tiempo y el cuerpo) con este secreto y solo acepta mensajes cuya marca de tiempo se desvíe como mucho cinco minutos. Los eventos del otro modo distinto al de tu clave (prueba en lugar de producción o al revés) se aceptan y se omiten. Se registran los pagos de los enlaces de pago de VentionDesk y los reembolsos. La guía completa: Conectar Stripe.
Sentry
En la integración interna, en «Webhooks», marca «issue» e introduce la URL como «Webhook URL». El client secret de la integración lo introduces en VentionDesk; VentionDesk lo usa para comprobar la firma Sentry-Hook-Signature (HMAC-SHA256 sobre el cuerpo). Los errores nuevos y reabiertos aparecen entonces al momento. Guía: Conectar Sentry.
Bugsnag
En el proyecto, en Project settings › «Integrations and email» › «Webhook», introdúcela y elige «New errors», «Frequently occurring errors» y «Reopened errors». Bugsnag no firma; por eso el secreto va en la URL y se compara. Guía: Conectar Bugsnag.
Rollbar
En el proyecto, en Settings › Notifications › «Webhook», introdúcela y activa «New Item», «Reactivated Item», «Resolved Item» y «10^nth Occurrence». Como en Bugsnag, el secreto va en la URL. Guía: Conectar Rollbar.
De los rastreadores de errores, VentionDesk solo toma metadatos — ID, título abreviado, nivel, estado, contador, primera y última aparición y el enlace. Las trazas de pila, los cuerpos de los eventos, los datos de usuarios y las direcciones IP se quedan en el proveedor, aunque vengan en el webhook.
GitHub
Para GitHub no introduces nada: la app de VentionDesk entrega pushes, pull requests, check runs y estados de despliegue automáticamente en cuanto está instalada. Consulta Conectar GitHub.
Cómo responde VentionDesk
- Cada entrega cuenta una vez. Una entrega repetida con el mismo ID se reconoce y no se procesa dos veces.
- Firma o secreto incorrectos: la entrega se rechaza.
- Si VentionDesk no puede guardar una entrega, responde con un error en lugar de 200 — el proveedor la vuelve a entregar y no se pierde nada en silencio.
- Por dirección IP, cada ruta de webhook acepta hasta 600 entregas por minuto.