Linear

  L'integrazione Linear offre potenti funzionalità di gestione dei progetti al vostro chatbot dotato di intelligenza artificiale. Collegate senza problemi Botpress con Linear, un moderno strumento di tracciamento dei problemi e di gestione del flusso di lavoro. Grazie a questa integrazione, è possibile automatizzare la creazione di attività, tracciare i progressi e collaborare ai progetti direttamente all'interno del chatbot. Il chatbot può creare, aggiornare e recuperare i problemi di Linear , assegnare compiti ai membri del team, tenere traccia delle date di scadenza e altro ancora. Semplificate i processi di gestione dei progetti e migliorate la produttività del team con l'integrazione Linear per Botpress.

## Migrare dalla versione `0.x` alla `1.x`

La versione `1.0` dell'integrazione Linear richiede ora agli utenti di fornire un segreto di firma webhook . Se si usa l'autenticazione OAuth, questo cambiamento non ha effetto. Se si usa una chiave API per autenticarsi con Linear, è necessario fornire un segreto di firma webhook per garantire una comunicazione sicura tra Botpress e Linear. Per ottenere il segreto di firma di webhook , seguire le istruzioni della sezione _Configurazione manuale con una chiave API_.

## Configurazione

### Configurazione automatica con OAuth (consigliata)

Questo è il modo più semplice per configurare l'integrazione. Per configurare l'integrazione di Linear utilizzando OAuth, fare clic sul pulsante di autorizzazione e seguire le istruzioni per connettere il chatbot Botpress a Linear. Questo metodo è consigliato perché semplifica il processo di configurazione e garantisce una comunicazione sicura tra il chatbot e Linear.

Quando si utilizza questa modalità di configurazione, per connettersi all'area di lavoro Linear verrà utilizzata un'applicazione Botpress gestita da Linear . L'applicazione avrà i permessi necessari per amministrare problemi, commenti ed eseguire operazioni per conto degli utenti. Se si desidera un controllo più granulare sui permessi, si può optare per la modalità di configurazione manuale.

### Configurazione manuale con una chiave API

Se si preferisce configurare manualmente l'integrazione, è possibile fornire una chiave API per connettere il proprio account personale Linear a Botpress. Tenere presente che quando si utilizza una chiave API, le azioni intraprese dal bot saranno attribuite all'account personale Linear . Se si desidera che le azioni siano attribuite alla propria organizzazione invece che al proprio account personale, è necessario utilizzare l'autenticazione OAuth. L'autenticazione OAuth offre molti vantaggi rispetto alle chiavi API e non consuma un posto all'interno dell'organizzazione Linear .

Per configurare l'integrazione con Linear utilizzando una chiave API personale, procedere come segue:

### Creazione di una chiave API Linear 

1. Su Linear, accedere alle impostazioni dell'account e selezionare la scheda API nella barra laterale di navigazione.
2. In _Chiavi API personali_, inserire un nome per la propria chiave API e fare clic sul pulsante _Crea nuova chiave API_.
3. Salvate questa chiave API in un luogo sicuro. Sarà necessaria per configurare l'integrazione di Linear in Botpress.

### Iscrizione agli eventi di Linear webhook  

1. In Botpress, navigare nella pagina di configurazione dell'integrazione per Linear.
2. Copiare l'URL di webhook generato da Botpress.
3. Su Linear, accedere alle impostazioni dell'account e selezionare la scheda API nella barra laterale di navigazione.
4. Sotto _Webhooks_, fare clic sul pulsante _Create new webhook_.
5. Inserire un nome per webhook e incollare l'URL di webhook generato da Botpress nel campo _URL_.
6. Copiare il segreto di firma di webhook in un luogo sicuro. Ne avrete bisogno per configurare l'integrazione di Linear in Botpress.
7. In _Eventi di modifica dei dati_, selezionare gli eventi che si desidera sottoscrivere:

- `Esiti`: Ricevere notifiche quando le questioni vengono create, aggiornate o cancellate.
- Commenti": Ricevere notifiche quando vengono aggiunti commenti ai problemi.

8. In _Team_, selezionare i team per i quali si desidera ricevere le notifiche.
9. Fare clic sul pulsante _Crea webhook_ per salvare le modifiche.

### Configurazione dell'integrazione di Linear in Botpress

1. In Botpress, navigare alla pagina di configurazione dell'integrazione per Linear.
2. Selezionare l'opzione _Configura Linear con una chiave API_.
3. Inserire la chiave API ottenuta da Linear nel campo _chiave API_.
4. Inserire il segreto di firma di webhook ottenuto da Linear nel campo _Webhook Signing Secret_.
5. Salvare la configurazione e attivare l'integrazione.
6. Copiare l'URL webhook generato da Botpress.

## Limitazioni

Le limitazioni dell'API standard di Linear si applicano all'integrazione di Linear in Botpress. Queste limitazioni includono limiti di velocità, restrizioni sulle dimensioni del payload e altri vincoli imposti dalla piattaforma Linear . Assicurarsi che il bot rispetti queste limitazioni per mantenere prestazioni e affidabilità ottimali.

Maggiori dettagli sono disponibili nella [Linear documentazione API](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting).