Linear

In Botpress Studio, select Explore Hub in the upper-right corner.

Search for the Linear integration, then select Install Integration.

In the Configuration menu, select Authorize Linear.

Follow the on-screen instructions to connect Botpress to your Linear workspace.

On Linear, navigate to your account settings and select the API tab in the navigation sidebar.

Under Personal API keys, enter a name for your API key and select Create new API key.

Save this API key in a secure location. You will need it to configure the Linear integration in Botpress.

In Botpress, open the Configuration page for the Linear integration.

Copy the Webhook URL generated by Botpress.

On Linear, go to your account settings and select the API tab in the navigation sidebar.

Under Webhooks, select Create new webhook.

Enter a name for the webhook and paste the webhook URL from Botpress into the URL field.

Copy the webhook signing secret and store it in a secure location. You will need it to configure the Linear integration in Botpress.

Under Data change events, choose the events to subscribe to:

• Issues: Receive notifications when issues are created, updated, or deleted.
• Comments: Receive notifications when comments are added to issues.

Under Teams, select the teams you want to receive notifications for.

Select Create webhook to save your changes.

In Botpress, open the Configuration page for the Linear integration.

Select Configure Linear with an API Key.

Enter the API key from Linear in the API Key field.

Enter the webhook signing secret from Linear in the Webhook Signing Secret field.

Save the configuration and enable the integration.