add intro documentation and user guide

2025-05-29 19:29:32 +05:30
parent f429db89b4
commit 7808634432
203 changed files with 8020 additions and 7794 deletions
@@ -0,0 +1,43 @@
+---
+title: Setting Up Linear Integration
+description: Configure Linear integration to track issues and features from Chatwoot
+sidebarTitle: Linear
+---
+
+Setting up Chatwoot Linear integration involves 5 steps.
+
+1. Create a Linear app in the [developer portal](https://linear.app/settings/api/applications/new).
+2. Add necessary details and save the app.
+3. Configure Chatwoot with the `Client ID` and `Signing Secret` obtained from the Linear app.
+4. Open Chatwoot UI, navigate to integrations, select Linear, and click connect.
+5. Voila! You should now be able to use Linear in your Chatwoot account.
+
+## Register and configure the Linear app
+
+To use Linear Integration, you need to create a Linear app in the developer portal. You can find more details about creating Linear apps at the [Linear developer portal](https://developers.linear.app/docs/oauth/authentication).
+
+1. Create a Linear app.
+2. Obtain the `Client ID` and `Client Secret` for the app and configure it in your app config via `{Chatwoot installation url}/super_admin/app_config?config=linear`
+3. The callback URL should be `{Chatwoot installation url}/linear/callback`.
+4. Toggle the `Public` switch to make the app public.
+
+![linear_app_domain](/self-hosted/images/linear/create-app.png)
+
+## Configure Linear app config
+
+Obtain the `Client ID` and `Client Secret` for the app and configure it in your app config via `{Chatwoot installation url}/super_admin/app_config?config=linear`. These values will be available when you create the app in the developer portal.
+
+```bash
+LINEAR_CLIENT_ID=
+LINEAR_SIGNING_SECRET=
+```
+
+Restart the Chatwoot server.
+
+<Note>
+Linear will only show up in the integrations section once you have configured these values and restarted the server.
+</Note>
+
+## Connect Chatwoot with your Linear account
+
+Follow this [guide](https://chatwoot.help/hc/user-guide/articles/1739949089-how-to-track-issues-and-features-with-linear-integration) to complete the Linear integration.