Skip to main content

Slack integration

Post Somiti announcements and event updates directly to a Slack channel. When your community publishes an announcement or an event, Slack gets a message automatically.

Connect Slack

Somiti connects to Slack through an incoming webhook. You’ll create the webhook in Slack, then paste the URL into Somiti.

In Slack:

  1. Go to api.slack.com/apps and click Create New App.
  2. Choose From scratch, give it a name (like “Somiti”), and pick your workspace.
  3. In the app settings, click Incoming Webhooks and toggle it on.
  4. Click Add New Webhook to Workspace, choose the channel you want to post to, and click Allow.
  5. Copy the webhook URL. It starts with https://hooks.slack.com/services/.

In Somiti:

  1. Go to Settings and click the Integrations tab.
  2. Find Slack and click Connect.
  3. Paste the webhook URL into the Webhook URL field.
  4. Optionally, enter a Channel if you want to override the default channel set in Slack (e.g. #announcements). Leave this blank to post to the channel you picked in step 4 above.
  5. Optionally, change the Bot Username (default: Somiti) and Icon Emoji (default: :mega:).
  6. Click Save.

After saving, click Test to send a test message to your channel. If it arrives, the connection’s working.

Note: You’ll need permission to add apps to your Slack workspace. If you’re not a Slack admin, ask whoever manages your workspace to set this up.

Choose what Somiti sends to Slack

By default, no notifications are turned on. You choose which events trigger a Slack message.

  1. Go to Settings > Integrations and click your Slack integration.
  2. Click Edit.
  3. Under Triggers, check the events you want:
Event What gets posted
When an announcement is published The announcement title and a preview of the content
When an event is published The event name, date, time, and location
When an event is cancelled The event name and its original date
  1. Click Save.

Somiti starts posting to Slack for every event you’ve checked. To stop a specific event from posting, uncheck it and save again.

See Notifications for the in-app and email notification settings that are separate from this integration.

Check if it’s working

On the integration’s detail page (go to Settings > Integrations, then click View next to Slack) you can see:

  • Status: Active or Inactive
  • Messages sent: how many Slack messages Somiti has posted
  • Last triggered: when the last message was sent

If there’s a delivery error, a red warning box appears at the bottom showing what went wrong and when it happened.

To send a test message at any time, click Test at the top of the detail page.

Disconnect Slack

  1. Go to Settings > Integrations.
  2. Click View next to Slack, then click Delete.
  3. Confirm when prompted.

Warning: This removes the integration from Somiti. Your Slack workspace and the webhook you created aren’t affected, but Somiti stops posting messages immediately.

Troubleshooting

Test message didn’t arrive

  • Double-check the webhook URL. It should start with https://hooks.slack.com/services/ and have no trailing spaces.
  • Make sure the channel you picked when creating the webhook still exists.
  • If you entered a channel override in Somiti, check that the channel name is correct and the bot has been invited to it.

Notifications stopped arriving

  • Check the integration’s detail page for a red error box. The error message usually tells you what went wrong.
  • In Slack, go to the app settings and confirm the webhook is still active.
  • Click Test to see if the connection still works.

Want to post to a different channel

Edit the integration (go to Settings > Integrations, click Edit next to Slack) and update the Channel field. Or, go back to Slack and create a new webhook pointed at the new channel, then update the webhook URL in Somiti.

  • Notifications - Control in-app and email notifications for your community
  • Settings - All community settings