Integraciones
Conectar Sentry
Los errores abiertos de tus proyectos de Sentry aparecen en los proyectos; los nuevos, al instante.
Dónde se conecta
En VentionDesk, en Operaciones › Fuentes › «Añadir fuente», categoría Errores, y después Sentry. Solo el propietario puede conectar, editar y quitar.
Paso a paso
- En Sentry, abre Settings › Developer Settings › Custom Integrations y haz clic en «Create New Integration» › «Internal Integration». Nombre: «VentionDesk».
- Deja los permisos lo más restringidos posible: Project «Read», Issue & Event «Read», Organization «Read», todo lo demás «No Access». Así VentionDesk solo lee.
- Para el botón «Resuelto» (en VentionDesk y para Claude con «Marcar errores como resueltos»), pon Issue & Event en «Read & Write» — es el alcance event:write. VentionDesk marca entonces el error como resuelto primero en Sentry y solo después en su lado. Sin este permiso, VentionDesk solo lee: «Resuelto» deja entonces el error abierto y te indica qué permiso falta.
- En «Webhooks», marca «issue». Tras guardar, VentionDesk muestra la dirección del webhook en «Operaciones» › «Fuentes» › Sentry; introdúcela después como «Webhook URL».
- Guarda la integración, copia el token en «Tokens» y el client secret en «Credentials», e introduce ambos aquí junto con el slug de la organización. VentionDesk comprueba el acceso consultando los issues abiertos.
- VentionDesk trae cada diez minutos los issues abiertos de los proyectos asignados; el webhook avisa al instante de los nuevos y de los reabiertos. Después, en la página del proyecto, en «Analítica» › «Asignar fuente de errores», asigna cada proyecto a su proyecto en el proveedor.
- De cada error, VentionDesk solo toma el identificador, un título acortado (las direcciones de correo e IP que contenga se enmascaran), el nivel, el estado, el número de eventos y de usuarios afectados, la primera y la última aparición y el enlace al proveedor. Las trazas de pila, los eventos, los datos de usuarios, las direcciones IP y las peticiones se quedan en el proveedor y tampoco se guardan desde los webhooks.
Qué pide el diálogo
| Campo | Dato | De dónde |
|---|---|---|
| Token de API | Obligatorio | secreto | El token de la integración interna (Settings › Developer Settings › Custom Integrations › tu integración › Tokens). |
| Slug de la organización | Obligatorio | Está en la dirección: sentry.io/organizations/<slug>/ o <slug>.sentry.io. |
| Región | opcional | «de» para cuentas en la región de la UE (de.sentry.io); si no, déjalo vacío. No se admiten servidores de Sentry autoalojados. |
| Client secret | opcional | secreto | Solo para el webhook: VentionDesk lo usa para comprobar la firma (Sentry-Hook-Signature). Está en la integración, en «Credentials». |
| Crear tareas automáticamente | opcional | «an» (predeterminado, activado) o «aus» (desactivado). Activado: un error que alcanza el umbral o tiene el nivel «fatal» se crea una vez como tarea para Claude. |
| Umbral (eventos) | opcional | La tarea se crea a partir de este número de eventos. Déjalo vacío para 10. |
VentionDesk guarda los datos secretos cifrados y no vuelve a mostrarlos nunca. Solo se guardan cuando el proveedor confirma el acceso; si editas una conexión y dejas vacío un campo secreto, se mantiene el valor anterior.
Todos los proveedores de un vistazo: IntegracionesDirecciones de webhook: Webhooks