Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.insito.app/llms.txt

Use this file to discover all available pages before exploring further.

The Slack integration posts a Block Kit notification to a channel of your choice every time a response lands. Setup takes about a minute once you have admin access to your Slack workspace.

​
What you get

For each submitted response, Insito posts a message containing:
  • Which survey fired
  • The respondent’s userId and platform
  • Each answer (NPS scores get a 🟢🟡🔴 colour cue based on the detractor/passive/promoter bucket)
  • A link back to the full response detail in the dashboard

​
Setup

1

Open Insito's Slack settings

admin.insito.app → Settings → Integrations → Slack.
2

Click Connect Slack

You’ll be sent to Slack’s OAuth consent screen. Insito requests the incoming-webhook scope only — we never read messages or other channels.
3

Pick a channel

Slack will ask which channel to post to. Pick (or create) something like #feedback or #insito-responses. Public channels are easier — Insito can’t be invited to private channels post-hoc; you’d need to re-run the OAuth flow.
4

Verify

Insito sends a test message right after the OAuth callback completes. If you don’t see it in the channel within a few seconds, check Slack notifications aren’t filtering it.

​
Configuration

After connecting, the integration is on for all surveys in the project. To disable per-survey, open the survey → Settings → Integrations and toggle the Slack switch. You can connect multiple Slack workspaces to one project (if you have e.g. a “team” workspace and a “stakeholders” workspace), but only one channel per workspace.

​
Reconnecting

Slack tokens don’t expire, but if a user uninstalls Insito’s Slack app, the integration goes silent. The dashboard shows a red banner in Settings → Integrations → Slack when this happens — click Reconnect to re-run OAuth.

​
Disconnecting

Settings → Integrations → Slack → Disconnect. Removes the webhook on Insito’s side and revokes the token. Slack’s Apps Manage page is the place to fully remove the integration from your workspace.

​
Customising the message

Right now the message format is fixed. We’re tracking a few extensions:
  • Per-survey channel routing
  • Custom message templates with Liquid-style variables
  • Threading replies for follow-up questions
If you’d find these useful, email us so we can prioritise.

​
Troubleshooting

SymptomLikely cause
No messages arrivingInsito Slack app was removed by a workspace admin. Reconnect from Settings → Integrations.
Messages arriving for some surveys but not othersPer-survey toggle is off. Check Survey → Settings → Integrations.
Wrong channelOAuth flow remembers the last picked channel. Disconnect + reconnect to choose a new one.
Mentions / formatting brokenThe Block Kit message is plain text in the answer body. Mentions in user-submitted answers aren’t expanded.