Una integración es una dirección (webhook URL) a la que otro sistema puede enviar una solicitud. frego usa esa solicitud para crear una tarea en el proyecto. Es útil, por ejemplo, para reportes de errores de tu web, un formulario para clientes o errores de Sentry.
Nueva integración
- En el proyecto, abre Integraciones en el menú.
- Haz clic en Añadir integración y ponle un nombre.
- Elige el Tipo: Genérica o Sentry.
- Configura qué tareas debe crear: título, prioridad, etiqueta y la columna donde deben aparecer.
- Copia la URL del webhook y pégala en el otro sistema.
Puedes tener varias integraciones en un mismo proyecto, cada una con su propia configuración y dirección. Si en algún momento no necesitas alguna, puedes desactivarla con el interruptor.
Integración genérica
El otro sistema envía un POST a la dirección con un cuerpo JSON. Solo el campo description es obligatorio. Opcionalmente también puede enviar title, priority (high, medium o low) y tag, que sobrescriben tu configuración predeterminada. También puede incluir una imagen, que se añadirá a la tarea como archivo adjunto.
En el campo description puedes poner texto normal. También admite HTML sencillo: párrafos, listas, enlaces e imágenes. frego eliminará todo lo demás de la descripción, incluidos los scripts.
Sentry
Con el tipo Sentry, frego te muestra directamente en la integración los pasos para conectarla con Sentry. A partir del error, completa automáticamente el título, la descripción y la prioridad de la tarea. Si el mismo error vuelve a aparecer, no se crea una nueva tarea.
Quién se entera
Cuando una integración crea una tarea, todos los miembros del proyecto reciben una notificación.
FREE o PRO
Las integraciones las configura el propietario del proyecto y forman parte de PRO. Cuando termina tu PRO, las integraciones que ya tengas siguen creando tareas con normalidad. Sin embargo, no podrás añadir nuevas ni editar las existentes.
AtenciónLa dirección de la integración funciona como una contraseña. Si cae en manos equivocadas, haz clic en Regenerar token. La dirección anterior dejará de funcionar y deberás configurar la nueva en el otro sistema.