Skip to content

Update Slack integration docs for marketplace compliance #1133

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

codegen-sh[bot]
Copy link
Contributor

@codegen-sh codegen-sh bot commented Jun 12, 2025

This PR updates the Slack integration documentation to address feedback from Slack marketplace reviewers and ensure compliance with their requirements.

Changes Made

✅ Privacy Policy Link (Feedback #4)

✅ AI Disclaimer (Feedback #5)

  • Added comprehensive "AI Components and Usage" section explaining:
    • AI-powered functionality and capabilities
    • How AI processes data from Slack messages
    • AI limitations and recommendations for code review

✅ Pricing Information (Feedback #8)

✅ Enhanced Permissions Documentation (Feedback #7)

  • Restructured permissions section with detailed explanations
  • Added specific scope clarifications:
    • mpim:read - For group DM functionality
    • chat:write.customize - For custom usernames/avatars when representing different contexts
    • users:read.email - For mapping Slack accounts to Codegen accounts for proper authentication
  • Explained why each permission is necessary

✅ Privacy Enhancements (Feedback #2)

  • Clarified that private channel names are anonymized as "Private channel" for non-members
  • Enhanced privacy metadata handling explanation

Slack Marketplace Feedback Addressed

This PR directly addresses the following feedback items from Slack reviewers:

Remaining Technical Issues

The following items require code changes (not documentation) and are outside the scope of this PR:

Files Changed

  • docs/integrations/slack.mdx - Updated with all compliance requirements

💻 View my workAbout Codegen

- Add privacy policy link as required by Slack reviewers
- Add comprehensive AI disclaimer explaining AI components and usage
- Add pricing information section with link to pricing page
- Enhance permissions section with detailed scope explanations
- Clarify mpim:read, chat:write.customize, and users:read.email usage
- Address private channel name anonymization in privacy section

Addresses Slack marketplace feedback items #2, #4, #5, #7, and #8
Copy link

codecov bot commented Jun 12, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

✅ All tests successful. No failed tests found.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Copy link
Contributor Author

codegen-sh bot commented Jun 12, 2025

I see a check failed - I'm on it! 🫡

💻 View my work

Remove extra asterisks in mpim:read permission description that were causing test failures.
Copy link
Contributor Author

codegen-sh bot commented Jun 12, 2025

✅ Fixed failing check in this commit. The issue was a markdown syntax error in the slack.mdx file - there were extra asterisks (**) at the end of line 90 that were breaking the markdown parsing in the tests.

💻 View my work • React 👍 or 👎

- **Send messages** - To communicate responses and provide updates

### Enhanced Communication Features
- **Customize message appearance** (`chat:write.customize`) - Allows Codegen to post messages with custom usernames and avatars when representing different contexts or providing specialized responses (e.g., when acting as a specific type of assistant or when providing updates from different integrated services)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@codegen remove this bullet about Customize message appearance

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll remove that bullet about customizing message appearance! ✅

💻 View my work

### Why These Permissions Are Necessary

- **Email mapping** enables secure account linking between Slack and Codegen, ensuring proper access control
- **Custom appearance** allows for clearer communication when Codegen is providing updates from different integrated services
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@codegen remove this bullet point mentioning custom appearance


- **Message Analysis:** Your Slack messages are processed by AI models to understand intent and generate appropriate responses
- **Code Context:** When working with repositories, AI models analyze relevant code to provide accurate assistance
- **Learning and Improvement:** AI interactions help improve response quality, but no personal data is used for model training without explicit consent
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@codegen Remove the learning and improvement bullet here

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Done! I've removed both requested items:

  1. Removed the "Customize message appearance" bullet point from the Enhanced Communication Features section
  2. Removed the "Custom appearance" reference from the permissions rationale
  3. Removed the "Learning and Improvement" bullet point from the AI Data Processing section

The changes have been pushed to PR #1133. The documentation now focuses on the core permissions and AI functionality without the customize appearance and learning improvement aspects.

🔄 View Updated PR #1133

💻 View my work • React 👍 or 👎

- Removed chat:write.customize scope explanation per feedback
- Removed custom appearance reference from permissions rationale
- Removed AI learning/improvement explanation per feedback
@joelaguero joelaguero merged commit c53c8e3 into develop Jun 12, 2025
15 of 17 checks passed
@joelaguero joelaguero deleted the codegen-bot/update-slack-docs-marketplace-compliance branch June 12, 2025 19:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant