Slack integration
Somiti can post to a Slack channel when you publish an announcement, publish an event or cancel an event. Your members who live in Slack see the news without opening the portal. Setting it up takes a Slack admin and an admin in Somiti.
Connect Slack
Somiti posts through a Slack incoming webhook: a private web address that posts into one channel. You make it in Slack, then give it to Somiti.
In Slack:
- Go to api.slack.com/apps and click Create New App.
- Choose From scratch, name it (for example “Somiti”) and pick your workspace.
- Click Incoming Webhooks and switch it on.
- Click Add New Webhook to Workspace, pick the channel Somiti should post to, and click Allow.
- Copy the webhook URL. It starts with
https://hooks.slack.com/services/.
You’ll need permission to add apps to your Slack workspace. If you don’t have it, ask whoever runs your Slack.
In Somiti:
Tip: The webhook URL works like a password: anyone who has it can post to your channel. Don’t paste it into an ordinary email or chat. Make a new webhook just for Somiti, so you can remove it in Slack and make another if it’s ever exposed.
- Go to Settings, click the Integrations tab, and click Connect on the Slack card.
- Give it a Name, like the channel’s name.
- Paste the URL into Webhook URL.
- Leave Channel, Bot Username and Icon Emoji empty. Slack ignores them for webhooks made through a Slack app like the one above: posts always go to the channel you picked in Slack, under your app’s name and icon.
- Under Event Triggers, check what Somiti should post (see the next section).
- Click Create Integration.
- Click Test on the page that opens. A “Connection successful!” message should appear in your channel.
Choose what gets posted
| Trigger | When it posts | What the post says |
|---|---|---|
| When an announcement is published | When you click Publish on an announcement | “New Announcement”, the title, and up to 500 characters of the text |
| When an event is published | When you click Publish on a draft event | “New Event”, the title, up to 300 characters of the description, when it starts, and where (the venue name, or Virtual or Hybrid) |
| When an event is cancelled | When you click Cancel Event | “Event Cancelled”, the title and the date it was going to happen |
The times in the posts are in UTC, not your community’s time zone, so a 6 PM event in New York shows as 10 PM (11 PM in winter). Mention the local time in the event’s description if that will confuse people.
Changing an event’s Status field on its edit form doesn’t post to Slack. Use the Publish and Cancel Event buttons. See Events and Announcements.
Check that posts are going out
Open Settings, click the Integrations tab, then View on the Slack card.
- Status says whether the connection is switched on.
- Messages Sent counts the posts that went through.
- Last Triggered says how long ago the last post went.
If a post fails, a red Last Error box appears near the bottom of the page:
The box goes away the next time Somiti posts an announcement or event to the channel. Clicking Test doesn’t clear it, even when the test works.
Somiti doesn’t retry a failed post. If an important announcement didn’t make it, post it in Slack by hand.
Turn Slack off or remove it
- To remove it: click Delete and click OK to confirm. Somiti stops posting straight away.
- To pause it: click Edit, uncheck Active and click Update Integration. Somiti keeps the settings, so you can check Active again later.
Either way, the app and webhook stay in your Slack workspace; remove them there if you don’t need them.
Troubleshooting
The test message didn’t arrive.
- Check the webhook URL starts with
https://hooks.slack.com/services/and has no spaces at the end. - Check the channel still exists. If the webhook’s channel was deleted or archived, make a new webhook in Slack.
Posts stopped arriving.
- Look for a Last Error box. “channel_not_found” means the channel is gone; “no_service” or “invalid_token” usually means someone removed the app or webhook in Slack.
- Check Status is Active.
- Click Test. If the test message arrives, the connection works again, but the old Last Error box stays until the next real post goes through.
You want to post to a different channel.
In Slack, add a new webhook for that channel. In Somiti, click Edit on the Slack connection, paste the new URL into Webhook URL and click Update Integration.
Related docs
- Integrations for connecting, testing and removing integrations
- Announcements for writing and publishing announcements
- Notifications for what members are told inside Somiti