This content is being deprecated.
Please see our new Kisi Docs portal at docs.kisi.io
Relevant section: Slack
Integration with Slack is possible by leveraging Event Webhooks.
When working with webhooks, some services require transformation or formatting of the data before it can be used. In these cases, it's possible to use a combination of Kisi's external webhook integration alongside a script or service that can accept the raw event data, then format and POST it to a secondary address.
In this example, we will demonstrate forwarding events from Kisi into Slack using an intermediate service called Zapier to capture and resend the data in the format Slack expects. As an alternative to using Zapier, you can create your own integration by leveraging Kisi's Open API and/or custom Slack Apps.
Set up Zapier Trigger
To set up the Zapier trigger:
- Sign in to Zapier
- Click on Make a Zap and choose Webhooks by Zapier as the Trigger
- Choose Catch Hook as the Trigger Event
- Click Continue
- In the next area, you're presented with a Custom Webhook URL. Copy this address, and navigate to your Kisi Admin app
Create Kisi Webhook
To create a Webhook integration:
- Sign in to your Kisi account
- Select your Kisi Place
- Under Setup, click on Integrations and then Add Integration
- Enter a friendly name for your integration, and choose Event Webhook from the Type dropdown menu
- In the URL field, enter the destination URL copied from Zapier
- Click Save
Set up Zapier Action
To complete the Zap:
- Return to Zapier and click Continue. You can test the trigger and verify it can read any recent Kisi events
- Click Continue and move on to Step 2 (Action setup)
- Choose Slack
- Choose the Action Event as Send Channel Message
- Click Continue.
- Sign in with Slack
- Choose the channel where you want the Kisi events to be shown
- User Message Text, use the Message captured by the Webhook in Step 1
- Enter the Bot Name and (optionally) an Icon
- Under Include a link to this Zap? select No
- Click Continue and test the Zap or turn it on. You should then start receiving messages in Slack (as shown below)
