SkyGiraffe’s Slackbot allows you to interact with our REST Endpoint directly through Slack.
This connectivity facilitates access to enterprise data and business functions through the Slack interface in a completely secure manner. A few use cases as shown in the video below illustrate both the simplicity and wide scope of functionality that can be exposed on Slack with this SkyGiraffe bot.
Think of SkyGiraffe as a black-box enterprise data connector that enables the following:
- Enterprise Authentication: Allows you have a single endpoint that integrates with enterprise Identity providers such as AD, ADFS and other custom providers while passing on permissions for on-prem and cloud enterprise data sources.
- Data Connectivity: Pulls and updates data from backend systems, e.g., Oracle, SAP, Salesforce, MSSQL, REST APIs, Office 365, Google apps and many other systems.
- Create Applications: Build simple and complex workflows that involve one or more systems and enables read and write operations with the SkyGiraffe studio.
- Please email [email protected] to receive a link to SkyGiraffe Studio. You must have Windows to install the Studio.
- Follow the installer to properly install the Studio (5 min).
- Log in the Studio and add your first data source (further instructions here).
- You can start with a test data source to start developing your Slackbots. Eventually, this will be your actual data source, but to get started, you can use Google Sheets as a test. You can mock up some data there and connect to it via our generic REST API for Google sheets found here - https://github.com/skygiraffe/gsheets-sg-rest-datasource
- Once you have completed the above 2 steps, you can create your first SkyGiraffe App.
- You can test your app by downloading the SkyGiraffe app from the Apple/Google store and logging in with the username/password that you used to set up the studio.
Cool. Here are the steps for that.
- Go https://api.slack.com/apps/new and enter the required information.
- Go to ‘App Credentials’ and enter the redirect url - https://slack2.skygiraffe.com/skyg/
- Go to Interactive Messages and provide the same URL as above.
- Next, go to slash commands and enter details. You can choose any slash command that you like, for example, “/mysg”. But make sure the redirect URL is the same as in the above steps.
You are now ready to test. The sequence of steps for testing will assume your slash command is called “/mysg”.
- Enter command /mysg in slack.
- You will be asked to authorize SkyGiraffe so that it can use Slack API.
- You will then be asked to enter your SkyGiraffe credentials.
- The Slack client will open in a browser and you can start with the command /mysg apps. This returns all SkyGiraffe applications you have access to, as interactive buttons.
The result will look something like this:
![SkyGiraffe applications on Slack] (https://download.skygiraffe.com/publicImages/sg_slack_view.png)
You can start clicking on these buttons to carry on the with the workflow.
###Sounds good but how do I get started with my own deployment?
That’s exactly why we have open sourced this code! Fork it, enhance it if you want, and get going.
All you will need is:
- JAVA (we used 1.8)
- Web container - Tomcat to deploy your JAVA code
- REDIS - for caching purposes
- Certificate authority certified SSL certificate
- Public URL that Slack can reach over SSL
Once you have these components and have built the war file from the code, follow the same steps from the test Slackbot deployment. The only difference being that you have your own URL instead of ours.
Please contact us at [email protected] with any questions or concerns.