Plugins & Api integrations

<p class="graf graf--p">Slack integration allows Chaskiq to sync conversation information with an Slack workspace. There are to ways to enable this, one is like an global app or like an installation for every app created on Chaskiq. The difference resides on how you will configure it later on the Chaskiq app&#x27;s integration section.</p><p class="graf graf--p"></p><p class="graf graf--p"></p><h2 class="graf graf--h3">Configure the App on Slack: </h2><p class="graf graf--p">To enable Slack on custom installations you need to do the following:</p><p>Go to Slack and create new app</p><p>Configure with your app info</p><p>Configure Chaskiq keys</p><h3 class="graf graf--h4">Create new app in Slack</h3><p class="graf graf--p">Go to Slack App basic information and activate the following features for your app</p><p class="graf graf--p"></p><figure class="graf graf--figure"><div><div class="aspectRatioPlaceholder is-locked"><div class="aspect-ratio-fill" style="padding-bottom:69.80273141122913%"></div><img src="/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaElCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0a124092da6fdd2845d75c2dfa05ab0d4d4ea992/image.png" class="graf-image" contenteditable="false"/></div></div><figcaption class="imageCaption"><span><span data-text="true">App features</span></span></figcaption></figure><p class="graf graf--p">You will be asked for url for Chaskiq to receive data, then you may use this schema for url:</p><p class="graf graf--p"><b>https://YOURCHASKIQDOMAIN/api/v1/hooks/global/slack</b></p><p class="graf graf--p">This will be the same url for Events API and for Interactive Elements</p><p class="graf graf--p"></p><h3 class="graf graf--h4">Events API</h3><p class="graf graf--p">You have to add events type for listening Slack workspace activity. Chaskiq only need one, that&#x27;s is <a href="https://api.slack.com/events/message.channels">message.channels</a> on Bot events.</p><p class="graf graf--p"></p><figure class="graf graf--figure"><div><div class="aspectRatioPlaceholder is-locked"><div class="aspect-ratio-fill" style="padding-bottom:44.19306184012066%"></div><img src="/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaFFCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c30c2577b7d69a5aab62b4f3c8daed17d907873a/image.png" class="graf-image" contenteditable="false"/></div></div><figcaption class="imageCaption"><span><span data-text="true">bot events</span></span></figcaption></figure><h3 class="graf graf--h4">Oauth Configuration</h3><p class="graf graf--p">For Chaskiq sucessfully authorizes the app you will need to add a redirect URL</p><p class="graf graf--p">Go to <b>Oauth &amp; Permission</b> section on your Slack app and add the following schema:</p><p class="graf graf--p">https://YOUR-DOMAIN/api/v1/oauth</p><p class="graf graf--p"></p><h3 class="graf graf--h4">Chaskiq configuration</h3><p class="graf graf--p">At this point you will have all the steps ready on Slack Side to configure the app, now you will need to add the credentials of the Slack app on the Chaskiq side, there are two ways, the global credentials and the per app credentials:</p><h3 class="graf graf--h4">Global credentials approach</h3><p class="graf graf--p">When you use this mode you have to set two ENV vars for Chaskiq to know that&#x27;s the intended behavior those vars are <b>SLACK_CLIENT_ID</b> <b>SLACK_CLIENT_SECRET </b>and you can get those on the <b><i>basic information</i></b> tab on Slack app. </p><p class="graf graf--p">The second step is to restart Chaskiq application to get the ENV vars changes. Last step is to update the Chaskiq packages, this is achiveable by running the following command</p><p>rails packages:update</p><p class="graf graf--p">Now your app will get global support for Slack apps.</p><h3 class="graf graf--h4">Per App Credentials approach</h3><p class="graf graf--p">This approach does not require that you have to set the ENV vars , instead you will need to set that on every Chaskiq account you will need to add Slack support.</p><p></p><p class="graf graf--p"></p><p class="graf graf--p">In both approaches you will need to go to your Chaskiq app and go to Settings -&gt; Integrations tab and authorize it against Slack. </p><p class="graf graf--p"></p><figure class="graf graf--figure"><div><div class="aspectRatioPlaceholder is-locked"><div class="aspect-ratio-fill" style="padding-bottom:52.77777777777778%"></div><img src="/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaFlCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--bfd3726be918d0346ba49beff2979da47ba938ce/image.png" class="graf-image" contenteditable="false"/></div></div><figcaption class="imageCaption"><span><span data-text="true">Chaskiq app Slack authorize, global approach</span></span></figcaption></figure><p class="graf graf--p">If you taken the second aproach (per app credentials) then you will ask to fill some information on Slack authorization Dialog (Api key, Secret)</p><p class="graf graf--p"></p><p class="graf graf--p">That&#x27;s all, Happy Slakin</p>

Slack integration allows Chaskiq to sync conversation information with an Slack workspace. There are to ways to enable this, one is like an global app or like an installation for every app created on Chaskiq. The difference resides on how you will configure it later on the Chaskiq app's integration section.

To enable Slack on custom installations you need to do the following:

Go to Slack App basic information and activate the following features for your app

You will be asked for url for Chaskiq to receive data, then you may use this schema for url:

https://YOURCHASKIQDOMAIN/api/v1/hooks/global/slack

This will be the same url for Events API and for Interactive Elements

You have to add events type for listening Slack workspace activity. Chaskiq only need one, that's is message.channels

For Chaskiq sucessfully authorizes the app you will need to add a redirect URL

Go to Oauth & Permission section on your Slack app and add the following schema:

At this point you will have all the steps ready on Slack Side to configure the app, now you will need to add the credentials of the Slack app on the Chaskiq side, there are two ways, the global credentials and the per app credentials:

When you use this mode you have to set two ENV vars for Chaskiq to know that's the intended behavior those vars are SLACK_CLIENT_ID SLACK_CLIENT_SECRET and you can get those on the basic information tab on Slack app. 

The second step is to restart Chaskiq application to get the ENV vars changes. Last step is to update the Chaskiq packages, this is achiveable by running the following command

Now your app will get global support for Slack apps.

This approach does not require that you have to set the ENV vars , instead you will need to set that on every Chaskiq account you will need to add Slack support.

In both approaches you will need to go to your Chaskiq app and go to Settings -> Integrations tab and authorize it against Slack. 

Chaskiq app Slack authorize, global approach

If you taken the second aproach (per app credentials) then you will ask to fill some information on Slack authorization Dialog (Api key, Secret)

You have to add events type for listening Slack workspace activity. Chaskiq only need one, that's is message.channels on Bot events.