This Val Town project sends notifications to Slack when a GitHub pull request is approved, with an optional merge button that appears when all required checks are passing.

1. Create a GitHub Personal Access Token (PAT):

   • Go to GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens
   • Create a new token with these permissions:
     • Repository access: Select repositories you want to monitor
     • Permissions:
       • Pull requests: Read and Write
       • Contents: Read and Write (for merging)
       • Metadata: Read-only
   • Save the token for the next step

2. Set up a GitHub Webhook:

   • Go to your repository → Settings → Webhooks → Add webhook
   • Payload URL: The URL of this Val (copy after deployment)
   • Content type: application/json
   • Select "Let me select individual events"
   • Check only "Pull request reviews"
   • Ensure "Active" is checked
   • Click "Add webhook"

1. Create a Slack App:

   • Go to Slack API Apps → Create New App → From scratch
   • Name your app and select your workspace
   • Click "Create App"

2. Enable Interactivity:

   • In your Slack app settings, go to "Interactivity & Shortcuts"
   • Toggle "Interactivity" to On
   • Set the Request URL to the URL of this Val (same as GitHub webhook URL)
   • Save Changes

3. Create an Incoming Webhook:

   • In your Slack app settings, go to "Incoming Webhooks"
   • Toggle "Activate Incoming Webhooks" to On
   • Click "Add New Webhook to Workspace"
   • Select the channel where notifications should be posted
   • Copy the Webhook URL for the next step

1. Add Environment Variables:

   • In Val Town, add these environment variables:
     • GITHUB_TOKEN: Your GitHub Personal Access Token
     • SLACK_WEBHOOK_URL: Your Slack Incoming Webhook URL

2. Deploy the Val:

   • The Val is now ready to use
   • Copy the Val's URL to use in the GitHub webhook and Slack interactivity settings

1. GitHub sends a webhook event when a PR is reviewed
2. This Val filters for approval events
3. When an approval is detected, it:
   • Fetches detailed PR information
   • Checks if the PR is mergeable and all required checks are passing
   • Sends a formatted message to Slack
   • Includes a merge button if the PR can be merged
4. If the merge button is clicked, the Val:
   • Receives the interaction from Slack
   • Uses the GitHub API to merge the PR
   • Sends a confirmation message back to Slack

• No notifications in Slack: Check that the GitHub webhook is properly configured and sending events
• Merge button not appearing: The PR might have failing checks or merge conflicts
• Merge fails: Ensure your GitHub token has sufficient permissions for the repository

If you're not receiving notifications, you can use the included debug webhook to troubleshoot:

1. Use the debug webhook URL instead of the main Val URL in your GitHub webhook settings temporarily
2. Trigger a PR review in your repository
3. Check the logs in Val Town to see the exact payload being received
4. Common issues:
   • GitHub webhook not sending events (check webhook delivery in GitHub settings)
   • Incorrect event type (make sure "Pull request reviews" is selected)
   • Missing environment variables (check both GITHUB_TOKEN and SLACK_WEBHOOK_URL are set)
   • Permissions issues (verify your GitHub token has the correct permissions)