Slack

Cheqpoint sends rich messages to your Slack channel. Reviewers can be notified instantly — and with interactive buttons enabled, they can approve or decline without leaving Slack.

What you get

text
✅ Real-time notifications when requests arrive
✅ Interactive Approve / Decline buttons (optional — see below)
✅ Automatic message updates when a decision is made
✅ Anti-flood bundling — max 3 messages per 5 minutes

Step 1 — Basic notifications

This gets Cheqpoint sending messages to your Slack channel. Takes about 2 minutes.

  1. Go to api.slack.com/apps and click Create New App → From scratch.
  2. Give it a name (e.g. “Cheqpoint”) and choose your Slack workspace.
  3. In the left sidebar, go to Incoming Webhooks and toggle it On.
  4. Click Add New Webhook to Workspace and pick the channel to post to.
  5. Copy the webhook URL — it starts with https://hooks.slack.com/services/…
  6. In Cheqpoint, go to Notifications → Slack, paste the URL, and click Save settings.
  7. Click Test connection to confirm a message arrives in your channel.

Step 2 — Interactive buttons (optional)

This adds Approve and Decline buttons to Slack messages so reviewers can act directly without opening Cheqpoint. Requires enabling Interactivity in your Slack app.

  1. In your Slack App, go to Interactivity & Shortcuts in the left sidebar.
  2. Toggle Interactivity On.
  3. In the Request URL field, enter:
    https://app.cheqpoint.co/api/slack/actions
  4. Click Save Changes.
  5. Go to Basic Information → App Credentials and copy the Signing Secret.
  6. Back in Cheqpoint at Notifications → Slack, expand Interactive Buttons, paste your Signing Secret, and click Save settings.

Why do I need a Signing Secret?

When a reviewer clicks Approve or Decline in Slack, Slack sends a request to Cheqpoint. The Signing Secret lets Cheqpoint verify that the request genuinely came from your Slack app — not from a third party. Without it, interactive buttons cannot be enabled.

Testing the integration

  1. Use the Test connection button on the Notifications page to confirm the webhook works.
  2. Submit a test approval request via the SDK or the Developer → Request Logs test tool.
  3. A message should appear in your Slack channel. If interactive buttons are enabled, clicking Approve or Decline will update the request in Cheqpoint instantly.

Troubleshooting

No message in Slack after saving

Use Test connection — it sends a test message immediately. If it fails, double-check the webhook URL is complete and hasn't been truncated.

Buttons not working / “Invalid signature”

Make sure the Signing Secret matches the one shown in your Slack App under Basic Information → App Credentials. Re-copy and re-save it — there are no leading or trailing spaces.

Buttons not working / “Request URL not verified”

The Request URL in Slack must be exactly https://app.cheqpoint.co/api/slack/actions. Slack will send a challenge request when you save — Cheqpoint responds automatically.