diff --git a/docs/getting-started/slack-support.mdx b/docs/getting-started/slack-support.mdx new file mode 100644 index 000000000..333ee62fc --- /dev/null +++ b/docs/getting-started/slack-support.mdx @@ -0,0 +1,84 @@ +--- +sidebar_position: 4 +title: Get Support on Slack +--- + +# Get Support on Slack + +Join our [Permit.io Slack community](https://io.permit.io/docs-to-slack) to get help, share your experiences, and connect with other developers using Permit. + + +![Slack general channel](/img/slack/slack-1.png) + +## AI-Powered Support + +Our Slack workspace features an **AI support agent** that can answer your questions instantly. The AI agent is trained on our documentation and can help you with: + +- Code examples and SDK usage +- Policy configuration +- Troubleshooting common issues +- Quick answers to technical questions + +Simply ask your question in any channel, and the AI agent will provide helpful responses based on our extensive documentation. +To re-trigger the AI agent, tag `@Permit.io AI Agent` in your message. + +## Key Channels + +Our Slack workspace is organized into several channels to help you find the right place for your questions: + +### #permit-saas +Get support for Permit.io's SaaS platform, including: +- Account and workspace setup +- API and SDK questions +- Policy modeling and enforcement +- Integration assistance + +### #opal +Discussions about [OPAL (Open Policy Administration Layer)](https://www.opal.ac/), Permit's open-source policy administration solution: +- OPAL architecture and deployment +- Troubleshooting OPAL-related issues + +### #general +General discussions about authorization, access control, and Permit.io: +- Best practices and patterns +- Community discussions +- Feature requests and feedback +- Non-technical questions + +### #announcements +Stay updated with the latest news: +- Product updates and new features +- Release notes and version announcements +- Important community updates + +## Slack Commands + +We've added custom commands to help you manage support requests: + + +### `/permit-ticket-status` +Check the status of your support tickets directly from Slack: + +- View all your open tickets +- Check the status of a specific ticket +- Get updates on ticket progress + +**Usage:** Type `/permit-ticket-status [ticket-id]` to check a specific ticket. + +### `/permit-escalate` - Pro/Enterprise Support Only +Use this command in private channels to escalate an issue to our support team. This command: + +- Creates a support ticket from your Slack message +- Connects you directly with our support engineers +- Works in private channels or DMs (not in public channels) + +**Usage:** Type `/permit-escalate` followed by your question or issue description. + +## Getting Started + +1. **[Join our Slack workspace](https://io.permit.io/docs-to-slack)** +2. Introduce yourself in `#general` (optional but encouraged!) +3. Post your questions in the relevant channel +4. Use the AI agent for quick answers. + +We're here to help you succeed with Permit.io! diff --git a/sidebars.js b/sidebars.js index 12b640cb9..f803cd910 100644 --- a/sidebars.js +++ b/sidebars.js @@ -135,6 +135,11 @@ const sidebars = { "how-to/build-policies/abac/time-based-role", ], }, + { + type: "doc", + id: "getting-started/slack-support", + label: "Get Support on Slack", + }, ], }, { diff --git a/static/img/slack/slack-1.png b/static/img/slack/slack-1.png new file mode 100644 index 000000000..9ecd97ef8 Binary files /dev/null and b/static/img/slack/slack-1.png differ