Difference between revisions of "Slack"

From Hornbill
Jump to navigation Jump to search
 
(21 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
This document can now be found at its new location in the [https://docs.hornbill.com/ibridge-packages/welcome Hornbill Document Library].
  
<div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
+
    [[file:hornbill-document-library.png|iBridge Package Reference|link=https://docs.hornbill.com/ibridge-packages/welcome]]
__NOTOC__[[Main Page|Home]] > [[Integration]] > [[Business Process Automation & Orchestration]] > [[Hornbill iBridge]] > Slack
+
[[Category:HDOC]]
</div>
 
{|style="width: 100%"
 
|- valign="top"
 
|style="width:73%"|
 
[[File:Slack_logo.png]]
 
<br>
 
==Introduction==
 
Slack brings all your communication together in one place. It's real-time messaging, archiving and search for modern teams.
 
 
 
Keep your Slack teams up to date with what is happening in Hornbill and tickets in real time with Hornbill iBridge
 
|style="width:5%"|
 
|
 
|style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|
 
 
 
== Related Articles ==
 
:* [[Hornbill iBridge]]
 
:* [[Hornbill_KeySafe|KeySafe]]
 
:* [[Integration Call]]
 
:* [[Business_Process_Designer|Business Process Designer]]
 
|}
 
==Config==
 
[[File:Slack_Authorize.png|300px|right]]
 
Configure your '''Slack''' account authentication in '''[[Hornbill_KeySafe|KeySafe]]''' in order to use the Slack option above.
 
 
 
In the admin console > System > Security > KeySafe
 
 
 
* Select on '''+''' and select '''Slack'''
 
* Give the Slack KeySafe a Title (this is the name / identifier for the Slack account as you will see it when using the Integration Call node in your business process)
 
* Optionally add a description
 
* Select '''Create Key''' to save
 
 
 
Once the Key is created, you will need to connect to Slack and your account, in order to authorize the Hornbill App to perform the above options.
 
 
 
* Select '''Connect'''
 
 
 
You will be redirected to Slack in a pop up window, where you will be required to login to your Slack account, and then you will be prompted to review the option you are authorising the Hornbill App to be allowed to perform with the chosen Slack account, read and then select '''Authorize'''
 
 
 
Right your all set........
 
 
 
'''Managing Slack Configurations'''
 
 
 
* Use KeySafe to create, store and enable integrations with multiple Slack accounts for use in your business processes
 
* Use the '''Revoke Access''' option against a Slack account in KeySafe in order to revoke authentication rights for the Hornbill App to use the account
 
:* Note, this will revoke the rights of any existing Slack Integration Calls in your business processes, which are using the revoked Slack Account.
 
 
 
<br>
 
<br>
 
 
 
==Options==
 
Using the '''Integration Call''' in your business processes you can do the following with Slack
 
 
 
===Channels===
 
Create, update and Archive Channels, Add Users, and Get Channel information
 
===Chat===
 
Post, Update, Reply and Delete Messages
 
===Groups===
 
Create, Update, Close and Archive Groups
 
===Pins===
 
Pin Messages and remove Pins
 
===Reminders===
 
Create, Complete and Delete Reminders
 
===Users===
 
Get User info
 
 
 
==Example==  {{#ev:youtube|83FI0d_344s|350|right}}
 
 
 
In this example, we will choose and configure the Slack account to which we want to post a message.  We'll need to specify using KeySafe the Slack account and authentication details and authorize the Hornbill app to utilize this Slack account.
 
 
 
Through the business process designer we can then use the Integration Call node to decide where and how often we want to utilize the Slack integration, configuring the input parameters on each occasion, allowing if required the use of different Slack Accounts via different KeySafe configurations and different messages through the specific input parameters on each Integration Call node.
 
 
 
In this example we will simply use one Slack account, and define the message, and channel to post to including variables from the request the business process is running against.
 
 
 
Finally we'll use an output parameter to write the URL of the Slack Channel to the timeline of the request, this is not a required step but is useful for demonstration purposes or even to act as an audit trail.
 
 
 
[[Category:Integration]]
 

Latest revision as of 19:13, 10 April 2024

This document can now be found at its new location in the Hornbill Document Library.

   iBridge Package Reference