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
- Em Linear, navegue até às definições da sua conta e selecione o separador API na barra lateral de navegação.
- Em Personal API keys, introduza um nome para a sua chave de API e clique no botão Create new API key.
- 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
- Em Botpress, navegue até a página de configuração de integração para Linear.
- Copie o URL de webhook gerado por Botpress.
- Em Linear, navegue até às definições da sua conta e selecione o separador API na barra lateral de navegação.
- Em Webhooks, clique no botão Create new webhook.
- Introduza um nome para o webhook e cole o URL webhook gerado por Botpress no campo URL.
- Copie o segredo de assinatura de webhook num local seguro. Você precisará dele para configurar a integração Linear em Botpress.
- 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.
- Em Equipas, selecione as equipas para as quais pretende receber notificações.
- Clique no botão Create webhook para guardar as suas alterações.
Configurar a integração do Linear em Botpress
- Em Botpress, navegue até a página de configuração de integração para Linear.
- Selecione a opção Configurar Linear com uma chave de API.
- Introduza a chave da API que obteve em Linear no campo API Key.
- Introduza o segredo de assinatura de webhook que obteve em Linear no campo Webhook Signing Secret.
- Guarde a configuração e active a integração.
- 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.
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).
