A integração Linear traz poderosas capacidades de gestão de projectos para o seu chatbot alimentado por IA. Conecte perfeitamente Botpress com Linear, uma ferramenta moderna de rastreamento de problemas e gerenciamento de fluxo de trabalho. Com esta integração, pode automatizar a criação de tarefas, acompanhar o progresso e colaborar em projectos diretamente no seu chatbot. Capacite o seu chatbot para criar, atualizar e recuperar Linear problemas, atribuir tarefas a membros da equipa, acompanhar datas de vencimento e muito mais. Simplifique os seus processos de gestão de projectos e aumente a produtividade da equipa com a integração Linear para Botpress. ## Migrando da versão `0.x` para `1.x` A versão `1.0` da integração Linear requer agora que os utilizadores forneçam um segredo de assinatura webhook . Se utilizar a autenticação OAuth, não é afetado por esta alteração. Se utilizar uma chave de API para autenticar com Linear, tem de fornecer um segredo de assinatura webhook para garantir uma comunicação segura entre Botpress e Linear. Para obter o segredo de assinatura de webhook , siga as instruções na secção _Configuração manual com uma chave de API_ abaixo. ## Configuração ### Configuração automática com OAuth (recomendado) Essa é a maneira mais simples de configurar a integração. Para configurar a integração Linear usando OAuth, clique no botão de autorização e siga as instruções para conectar seu chatbot Botpress a Linear. Esse método é recomendado, pois simplifica o processo de configuração e garante uma comunicação segura entre seu chatbot e Linear. Ao usar esse modo de configuração, um aplicativo Linear gerenciado por Botpress será usado para se conectar ao seu espaço de trabalho Linear . A aplicação terá as permissões necessárias para administrar problemas, comentários e executar operações em nome dos seus utilizadores. Se necessitar de um controlo mais pormenorizado sobre as permissões, pode optar pelo modo de configuração manual. ### Configuração manual com uma chave de API Se preferir configurar manualmente a integração, pode fornecer uma chave de API para ligar a sua conta pessoal de Linear a Botpress. Tenha em atenção que, quando utiliza uma chave de API, as acções realizadas pelo bot serão atribuídas à sua conta pessoal de Linear . Se pretender que as acções sejam atribuídas à sua organização em vez de à sua conta pessoal, tem de utilizar a autenticação OAuth. A autenticação OAuth oferece muitas vantagens em relação às chaves de API e não consome um lugar na sua organização Linear . Para configurar a integração Linear usando uma chave de API pessoal, siga estas etapas: ### Criar uma chave de API Linear 1. Em Linear, navegue até às definições da sua conta e selecione o separador API na barra lateral de navegação. 2. Em _Personal API keys_, introduza um nome para a sua chave de API e clique no botão _Create new API key_. 3. Guarde esta chave de API numa localização segura. Precisará dela para configurar a integração Linear em Botpress. ### Subscrição de eventos Linear webhook 1. Em Botpress, navegue até a página de configuração de integração para Linear. 2. Copie o URL de webhook gerado por Botpress. 3. Em Linear, navegue até às definições da sua conta e selecione o separador API na barra lateral de navegação. 4. Em _Webhooks_, clique no botão _Create new webhook_. 5. Introduza um nome para o webhook e cole o URL webhook gerado por Botpress no campo _URL_. 6. Copie o segredo de assinatura de webhook num local seguro. Você precisará dele para configurar a integração Linear em Botpress. 7. Em _Data change events_, selecione os eventos que pretende subscrever: - `Issues`: Receber notificações quando os problemas são criados, actualizados ou eliminados. - `Comentários`: Receber notificações quando forem adicionados comentários aos problemas. 8. Em _Equipas_, selecione as equipas para as quais pretende receber notificações. 9. Clique no botão _Create webhook_ para guardar as suas alterações. ### Configurar a integração do Linear em Botpress 1. Em Botpress, navegue até a página de configuração de integração para Linear. 2. Selecione a opção _Configurar Linear com uma chave de API_. 3. Introduza a chave da API que obteve em Linear no campo _API Key_. 4. Introduza o segredo de assinatura de webhook que obteve em Linear no campo _Webhook Signing Secret_. 5. Guarde a configuração e active a integração. 6. Copie o URL webhook gerado por Botpress. ## Limitações As limitações padrão da API Linear aplicam-se à integração Linear em Botpress. Essas limitações incluem limites de taxa, restrições de tamanho de carga útil e outras restrições impostas pela plataforma Linear . Certifique-se de que o seu bot adere a estas limitações para manter o desempenho e a fiabilidade ideais. Mais detalhes estão disponíveis na [Linear documentação da API](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting).
