Slack

YipYap integrates with Slack to deliver alert notifications to your workspace channels. The integration includes interactive buttons for acknowledging and resolving alerts directly from Slack.

Bot Setup

1. Go to Settings > Notifications > Add Channel > Slack.
2. Click Install to Slack. This opens the Slack OAuth flow.
3. Select the workspace and channel where you want notifications delivered.
4. Authorize the YipYap bot.

The bot requires the following Slack permissions:

• chat:write to send messages.
• chat:write.public to post in public channels.

Channel Configuration

After installation, configure the channel:

• Channel: The Slack channel to post notifications to (e.g. #ops-alerts).
• Mention: Optionally mention a user or group in the notification (e.g. @oncall).

Interactive Buttons

Each alert notification includes two buttons:

• Acknowledge: Marks the alert as acknowledged and pauses the escalation policy.
• Resolve: Marks the alert as resolved and closes it.

Button presses are logged with the Slack user who clicked them.

Signature Verification

YipYap verifies the Slack signing secret on all incoming interactions to ensure that button clicks originate from Slack and have not been tampered with. The signing secret is configured automatically during the OAuth flow.

Webhook Fallback

If you prefer not to install the bot app, you can use a Slack Incoming Webhook URL instead. Configure it under Webhooks with the Slack auto-detect format. Note that webhook-based notifications do not support interactive buttons.

Troubleshooting

• Bot not posting: Verify the bot has been invited to the target channel (/invite @YipYap).
• Buttons not working: Check that the YipYap request URL is correctly configured in your Slack app settings.