Skip to content

Documentation

Slack

What Kicklace tells you, in one Slack channel.

Everything Kicklace tells the people who run a workspace (a reply arriving, an email bouncing, somebody joining, a sequence's note to you) can be posted to one Slack channel as well. One incoming webhook address, pasted once.

It's under Connections → Slack, and only an owner or an admin can change it.

Kicklace only writes to Slack. It reads nothing there, takes no instruction from anything typed in the channel, and never emails anybody because of it.

Setting it up

1. Make an incoming webhook in Slack.

  1. Open api.slack.com/apps, create an app from scratch, name it Kicklace, and pick your Slack workspace.
  2. Open Incoming Webhooks and turn Activate Incoming Webhooks on.
  3. Press Add New Webhook to Workspace, choose the channel, and allow it.
  4. Copy the address under Webhook URLs for Your Workspace. It looks like https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX.

Slack fixes the channel when you make the address. To post somewhere else, make a second webhook.

2. Paste it. Connections → Slack → Connect: the address, then a channel name, which is optional and only printed on the page.

3. Send a test. It posts Kicklace is connected to this channel. From then on, notices arrive as they happen.

The address is the secret

Anybody holding an incoming webhook address can write into your channel, so it's locked away and never shown back, and Kicklace refuses anything but https://hooks.slack.com/services/…. If it leaks, delete that webhook in Slack, make a new one, and press Replace.

What lands in the channel

One message per notice: the title in bold, the notice under it, and Open in Kicklace where there's somewhere to go.

What happened
Somebody replied to one of your emails
An email bounced, or was marked as spam
Your sending domain or reply address started or stopped working
Somebody joined the workspace
A new lead came in
A sequence on your Lifecycle map sent you a note
A record was deleted

What never lands there

  • Your own notifications. A mention in a note, or a task coming due, belongs to one person; a channel is a room.
  • The body of an email, past what Home shows.
  • A key, an address or a token.

When a post doesn't land

A post that fails on the way (a network wobble, a 500, a rate limit) is tried once more. What Slack said is then on the screen, like "The last post failed: Slack answered 404, the webhook was removed." The line clears the next time something lands, so Send a test after fixing it is how you know. Nothing is queued or replayed: what the channel missed is on Home.

Disconnect stops the posting. What's already in the channel stays there.