La integración de Linear aporta potentes funciones de gestión de proyectos a su chatbot basado en IA. Conecte sin problemas Botpress con Linear, una moderna herramienta de seguimiento de incidencias y gestión de flujos de trabajo. Con esta integración, puede automatizar la creación de tareas, realizar un seguimiento del progreso y colaborar en proyectos directamente dentro de su chatbot. Permita que su chatbot cree, actualice y recupere problemas en Linear , asigne tareas a los miembros del equipo, controle las fechas de vencimiento y mucho más. Agilice sus procesos de gestión de proyectos y mejore la productividad del equipo con la integración de Linear para Botpress. ## Migración de la versión `0.x` a la `1.x`. La versión `1.0` de la integración Linear ahora requiere que los usuarios proporcionen un webhook secreto de firma. Si utilizas autenticación OAuth, este cambio no te afecta. Si utiliza una clave API para autenticarse con Linear, debe proporcionar un secreto de firma webhook para garantizar una comunicación segura entre Botpress y Linear. Para obtener el secreto de firma de webhook , siga las instrucciones de la sección _Configuración manual con una clave API_. ## Configuración ### Configuración automática con OAuth (recomendada) Esta es la forma más sencilla de configurar la integración. Para configurar la integración de Linear mediante OAuth, haga clic en el botón de autorización y siga las instrucciones para conectar su chatbot Botpress a Linear. Se recomienda este método, ya que simplifica el proceso de configuración y garantiza una comunicación segura entre su chatbot y Linear. Al utilizar este modo de configuración, se utilizará una aplicación Linear gestionada por Botpress para conectarse a su espacio de trabajo Linear . La aplicación tendrá los permisos necesarios para administrar incidencias, comentarios y realizar operaciones en nombre de sus usuarios. Si necesita un control más detallado de los permisos, puede optar por el modo de configuración manual. ### Configuración manual con una clave API Si prefieres configurar manualmente la integración, puedes proporcionar una clave API para conectar tu cuenta personal de Linear a Botpress. Ten en cuenta que cuando utilices una clave API, las acciones realizadas por el bot se atribuirán a tu cuenta personal de Linear . Si deseas que las acciones se atribuyan a tu organización en lugar de a tu cuenta personal, debes utilizar la autenticación OAuth. La autenticación OAuth ofrece muchas ventajas sobre las claves API y no consume un puesto dentro de su organización Linear . Para configurar la integración de Linear utilizando una clave de API personal, siga estos pasos: ### Creación de una clave API Linear 1. En Linear, navega hasta la configuración de tu cuenta y selecciona la pestaña API en la barra lateral de navegación. 2. En _Claves API personales_, introduzca un nombre para su clave API y haga clic en el botón _Crear nueva clave API_. 3. 3. Guarde esta clave API en un lugar seguro. La necesitará para configurar la integración de Linear en Botpress. ### Suscripción a eventos de Linear webhook 1. En Botpress, navegue hasta la página de configuración de la integración para Linear. 2. 2. Copie la URL webhook generada por Botpress. 3. En Linear, navegue hasta la configuración de su cuenta y seleccione la pestaña API en la barra lateral de navegación. 4. En _Webhooks_, haga clic en el botón _Crear nuevo webhook_. 5. Introduzca un nombre para webhook y pegue la URL de webhook generada por Botpress en el campo _URL_. 6. 6. Copie el secreto de firma de webhook en un lugar seguro. Lo necesitará para configurar la integración de Linear en Botpress. 7. 7. En _Eventos de cambio de datos_, seleccione los eventos a los que desea suscribirse: - `Issues`: Reciba notificaciones cuando se creen, actualicen o eliminen incidencias. - Comentarios Reciba notificaciones cuando se añadan comentarios a las incidencias. 8. En _Equipos_, seleccione los equipos para los que desea recibir notificaciones. 9. Haga clic en el botón _Crear webhook_ para guardar los cambios. ### Configuración de la integración de Linear en Botpress 1. En Botpress, navegue hasta la página de configuración de la integración para Linear. 2. 2. Seleccione la opción _Configurar Linear con una clave API_. 3. Introduzca la clave API que obtuvo de Linear en el campo _API Key_. 4. 4. Introduzca el secreto de firma de webhook que obtuvo de Linear en el campo _Webhook Signing Secret_. 5. Guarda la configuración y habilita la integración. 6. Copie la URL webhook generada por Botpress. ## Limitaciones Las limitaciones estándar de la API Linear se aplican a la integración de Linear en Botpress. Estas limitaciones incluyen límites de velocidad, restricciones de tamaño de la carga útil y otras restricciones impuestas por la plataforma Linear . Asegúrese de que su bot respeta estas limitaciones para mantener un rendimiento y una fiabilidad óptimos. Encontrará más información en la [ documentación de la API deLinear ](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting).
