Channels

Slack

Put Relay in a Slack workspace so questions asked in a channel get answered in the thread.

Relay connects to Slack as an app, listening on the Events API and replying in thread.

Credentials

ValuePurpose
Signing secretVerifies that requests genuinely came from Slack
Client IDIdentifies your Slack app during install
Client secretCompletes the OAuth install

Set up

Create a Slack app

Create an app in your workspace and note the signing secret and OAuth credentials.

Point events at Relay

Set the Events request URL to Relay's Slack webhook endpoint. Slack sends a challenge to verify the endpoint before enabling it.

Install to the workspace

Complete the OAuth install. The app can then read the events it is subscribed to and post replies.

Request verification

Inbound requests are verified against the signing secret and a timestamp, which is what stops a replayed payload from being accepted as a fresh event.

Behaviour

Messages arrive as conversations in the inbox exactly as widget and WhatsApp messages do, and human replies route back into the Slack thread.

On this page