Slack webhook

The Slack webhook collects three things: whether anyone acknowledged an Intempt notification, whether your app is installed or removed from a workspace, and activity from external members in Slack Connect channels.

Read this before you plan on it: most of the value is account-level, not person-level. An install, an uninstall or an external workspace joining a shared channel says something about an account. A message in a channel says very little about a customer profile, and Slack withholds the one field that would link it.

Available events

Twelve Intempt events, drawn from a Slack Events API that publishes over 150 types. The small number is the point. The rest are workspace administration and carry no customer signal.

Each event is normalised onto a named stream, so you build segments and journey triggers on the event name rather than on the payload shape.

Slack has no ticket object. ticket_created and the two replies are Intempt's reading of a thread in an externally shared channel, based on whether the author's home workspace differs from yours. A reply is detected by thread_ts, not by subtype, because Slack documents that message_replied is missing its subtype over the Events API.

Identity

The identity key is the Slack user id, and it's workspace-scoped. A user id belongs to exactly one workspace and means nothing in another.

For a member of your own workspace, Intempt calls users.info and reads profile.email (this needs the users:read.email scope), so the profile resolves to a real person.

For an external member in a Slack Connect channel, users.info withholds email, even with the scope. The only place their address ever appears on the wire is shared_channel_invite_accepted, when they or their inviter accepted the shared channel. If Intempt saw that event for this user id, the profile gets an email. If it didn't, the profile stays keyed on the Slack user id alone, and there's no API call that fixes it later.

External workspaces become Intempt accounts, keyed on team_id. shared_channel_invite_accepted is also the one event that carries the workspace's name and domain.

Endpoint

The collector path for Slack events is:

https://<your collector host>/webhooks/events/slack

Slack doesn't let you add request headers, so the source token travels in the endpoint URL Intempt gives you. Intempt answers Slack's url_verification challenge automatically when you paste the URL. The envelope event_id is the idempotency key.

Historical load

Slack's historical load runs on the certified Airbyte source source-slack, using the same bot token you enter above. It loads channels, channel members, messages and users.

The Events API itself is push-only and replays nothing, so live coverage starts at the first delivery after you subscribe. The backfill is what fills in what came before.

Setup

Slack events are configured on the Slack app that also powers the destination. If you already set up the Slack destination, you're adding event subscriptions to that app. Create the source in Intempt first.

Configure Slack

1. Create a Slack source on the Integrations page and copy the endpoint URL.

2. At api.slack.com/apps, open your Intempt Slack app and go to Event Subscriptions. Turn it on and paste the Intempt endpoint as the Request URL. Slack sends a verification challenge; the field shows Verified when Intempt answers it.

3. Under Subscribe to bot events, add message.channels, message.groups, message.im, message.mpim, reaction_added, app_home_opened, app_uninstalled, tokens_revoked, member_joined_channel and shared_channel_invite_accepted. If the app is organization-wide, add app_installed, app_uninstalled_team and app_deleted too.

4. Under OAuth & Permissions, add the users:read and users:read.email scopes so users.info can resolve your own members to email.

5. Reinstall the app to the workspace so the new scopes and subscriptions take effect.

6. Send a test notification from an Intempt journey to a channel the app is in, react to it, and confirm messaged_slack_notification and reacted_slack_notification appear in the Intempt event stream.