Create Discussion Comment ⌨️💬✅

🚀 Automate your GitHub Discussions with ease! Add comments to existing GitHub Discussions seamlessly using GitHub Actions.

🌟 What is this Action?

The Create Discussion Comment action empowers you to programmatically add comments to your GitHub Discussions using GitHub Actions workflows. Whether you're building automated workflows, creating notification systems, or enhancing your community engagement, this action makes it simple to interact with GitHub Discussions at scale.

🎯 Perfect for:

• 🤖 Automated responses to discussion topics
• 📢 Notifications about workflow completions
• 💡 Bot interactions in community discussions
• 🔄 Cross-referencing issues and discussions
• 📊 Status updates on project milestones
• 🎉 Welcome messages for new community members

✨ Key Features

• 🎯 Targeted Comments: Add comments to specific discussions using their unique ID
• 🧵 Thread Replies: Reply to existing comments to maintain conversation flow
• 🔐 Secure Authentication: Uses GitHub Personal Access Tokens for secure API access
• 🏗️ Flexible Integration: Works with any GitHub Actions workflow
• 📝 Rich Content Support: Full markdown support in comment bodies
• 🆔 Custom Mutation IDs: Track your mutations with custom identifiers

🚀 Quick Start

Basic Usage

Add this step to your GitHub Actions workflow to create a comment on any discussion:

- name: 💬 Create Discussion Comment
  uses: wesleyscholl/[email protected]
  id: create-comment
  with:
    token: ${{ secrets.DISCUSS_TOKEN }}
    body: |
      ## 🎉 Workflow Completed Successfully!
      
      This comment was automatically generated by a GitHub Action.
      
      **Deployment Status**: ✅ Success  
      **Timestamp**: ${{ github.event.head_commit.timestamp }}
      **Commit**: ${{ github.sha }}
    discussion-id: 'D_kwdje64ife75s9o'
    client-mutation-id: 'workflow-${{ github.run_id }}'

Advanced Example: Replying to Comments

- name: 🔄 Reply to Discussion Comment  
  uses: wesleyscholl/[email protected]
  with:
    token: ${{ secrets.DISCUSS_TOKEN }}
    body: |
      👋 Thanks for your question! 
      
      Based on the latest deployment, here's the status update you requested:
      - ✅ Build completed
      - ✅ Tests passed  
      - ✅ Deployed to production
    discussion-id: 'D_kwdje64ife75s9o'
    replyToId: 'DC_kwdje64ife75s9o_reply'
    client-mutation-id: 'reply-${{ github.run_number }}'

📋 Configuration Options

🔧 Input Parameters

Parameter	Description	Required	Default	Example
token	🔑 GitHub Personal Access Token with appropriate permissions	✅ Yes	N/A	${{ secrets.DISCUSS_TOKEN }}
body	📝 The comment content (supports full Markdown)	❌ No	"Comment provided by GitHub Action create-discussion-comment"	"Hello from GitHub Actions! 👋"
discussion-id	🎯 The unique node ID of the target discussion	✅ Yes	N/A	'D_kwdje64ife75s9o'
client-mutation-id	🆔 Unique identifier for tracking the mutation	❌ No	"1234"	'workflow-${{ github.run_id }}'
replyToId	🧵 Node ID of the comment to reply to (for threaded replies)	❌ No	N/A	'DC_kwdje64ife75s9o'

📤 Output Data

Output	Description	Example
clientMutationId	🆔 The unique identifier you provided	"workflow-123"
comment	💬 The complete comment object that was created	See response example below

📊 Response Format

{
  "data": {
    "addDiscussionComment": {
      "clientMutationId": "workflow-123",
      "comment": {
        "id": "DC_kwdje64ife75s9o",
        "body": "🎉 Your automated comment content here!"
      }
    }
  }
}

🔍 Finding Your Discussion ID

Method 1: GitHub GraphQL Explorer 🔬

1. Visit the GitHub GraphQL Explorer
2. Use this query (replace <REPO_OWNER> and <REPO_NAME>):

query GetDiscussions($owner: String!, $name: String!) {
  repository(owner: $owner, name: $name) {
    discussions(first: 10, orderBy: {field: UPDATED_AT, direction: DESC}) {
      edges {
        node {
          id          # 🎯 This is your discussion-id!
          title
          number
          category {
            id
            name
            emoji
          }
          body
          createdAt
          updatedAt
          author {
            login
          }
        }
      }
    }
  }
}

Method 2: Discussion URL Pattern 🔗

You can also find the discussion ID in the browser:

1. Navigate to your discussion
2. The URL will look like: https://github.com/owner/repo/discussions/123
3. Use GraphQL to convert the number to the node ID

🛡️ Security & Permissions

Required Token Permissions 🔐

Your Personal Access Token needs these scopes:

• ✅ public_repo - For public repositories
• ✅ repo - For private repositories
• ✅ write:discussion - To create and modify discussion comments

🔒 Security Best Practices

1. Store tokens securely: Always use GitHub Secrets (${{ secrets.TOKEN_NAME }})
2. Minimal permissions: Only grant the minimum required scopes
3. Token rotation: Regularly rotate your Personal Access Tokens
4. Monitor usage: Keep track of where and how your tokens are used

🎨 Creative Use Cases

📊 Automated Status Reports

body: |
  ## 📊 Weekly Build Report
  
  **Period**: ${{ github.event.schedule }}
  
  ### 📈 Statistics
  - ✅ Successful builds: 47
  - ❌ Failed builds: 3
  - ⏱️ Average build time: 4m 32s
  
  ### 🏆 Top Contributors This Week
  @contributor1, @contributor2, @contributor3

🎉 Release Announcements

body: |
  ## 🚀 New Release: v${{ github.ref_name }}
  
  We're excited to announce our latest release! 
  
  ### ✨ What's New
  - 🐛 Bug fixes and performance improvements
  - 🆕 New features based on community feedback
  - 📚 Updated documentation
  
  **Download**: [Release Notes](https://github.com/${{ github.repository }}/releases/tag/${{ github.ref_name }})

🤖 Community Engagement

body: |
  ## 👋 Welcome to our community!
  
  Thanks for starting this discussion! Here are some helpful resources:
  
  - 📖 [Getting Started Guide](link)
  - 💬 [Community Guidelines](link)  
  - 🐛 [Bug Report Template](link)
  
  Our team will respond within 24-48 hours. Happy coding! 🎉

🧪 Example Workflows

Check out our example workflows to see the action in various scenarios:

• 🔄 CI/CD Status Updates: Automatically comment on discussions when builds complete
• 📅 Scheduled Reports: Weekly/monthly automated status reports
• 🎯 Issue Crosslinking: Link related issues and discussions automatically
• 🤖 Bot Responses: Create intelligent bot responses based on discussion content

🤝 Contributing

We welcome contributions! Here's how you can help:

• 🐛 Report bugs by opening an issue
• 💡 Suggest features through discussions
• 🔧 Submit pull requests with improvements
• 📖 Improve documentation
• ⭐ Star this repository to show your support

🚀 Development Setup

1. Fork this repository
2. Clone your fork: git clone https://github.com/YOUR-USERNAME/create-discussion-comment.git
3. Create a feature branch: git checkout -b feature/amazing-feature
4. Make your changes and test
5. Submit a pull request

🙏 Acknowledgments & Credits

This action was inspired by these amazing projects:

• 💬 peter-evans/create-or-update-comment - For comment management patterns
• 🗣️ abirismyname/create-discussion - For discussion creation workflows

Special thanks to all our contributors and the GitHub Actions community! 🎉

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Support & Community

• 🐛 Bug reports: Open an issue
• 💡 Feature requests: Start a discussion
• 📖 Documentation: GitHub Actions Documentation
• 💬 Community: GitHub Discussions

---

Made with ❤️ by @wesleyscholl

⭐ Star this repository if you found it helpful!

🏪 GitHub Marketplace • 📚 Documentation • 🐛 Issues • 💬 Discussions