Slack

Integrating Slack with Hyper allows developers to harness communication data, facilitating efficient data synchronization and interaction with Hyper's platform. This guide provides instructions to connect Slack for internal company or project data ingestion and for configuring Slack for Hyper Connect, where end-users can connect their communication data to Hyper.

Scenario 1: Internal Data Ingestion Using an API Key

For developers seeking to utilize internal communication data from their own company or project, here's how to set up the connection:

Connecting Slack in the Hyper UI

1. Access Hyper UI: Log into the Hyper user interface.

2. Navigate to Data Sources: Find the section where you can manage your data sources.

3. Add Slack: Choose Slack from the list of data sources and begin the connection process.

4. Authenticate: Authenticate using your Slack credentials and authorize Hyper to access your Slack workspace data.

5. Select Data: Pick specific channels or conversations from Slack that you wish to ingest into Hyper.

6. Start Querying: With the data ingested, utilize your API key to commence querying your data through Hyper's API.

Ingesting and Querying Data

After Slack is connected, developers can start the data ingestion process:

1. Use the Hyper API: Make requests to Hyper's endpoints to ingest data from the connected Slack workspace.

2. Query Data: Leverage Hyper's querying capabilities on the ingested data for insights and analysis.

Scenario 2: Hyper Connect Integration for User Data

To enable users to connect their Slack workspace data to Hyper via Hyper Connect, follow these additional steps:

OAuth Configuration for Slack

1. Create a Slack App: Visit the Slack API website and create a new Slack app. Obtain the credentials, like the Client ID and Client Secret.

2. Set Redirect URIs: Input the redirect URIs supplied by Hyper in your Slack app configuration.

3. Implement OAuth Flow: Incorporate the OAuth flow in your application to prompt users to grant access to their Slack workspace data.

4. Exchange Authorization Code for Tokens: After user approval, exchange the received authorization code for access and refresh tokens.

5. Secure Token Storage: Safely store the access and refresh tokens within your application's infrastructure.

6. Refresh Tokens: Craft a mechanism to refresh access tokens using the refresh tokens when necessary.

Access Control

For user data, developers may need to implement access control measures:

1. Define Access Levels: Ascertain various access levels for different user segments.

2. Enforce Role-Based Access Control: Assign user roles and enforce permissions corresponding to these roles.

3. Manage User Sessions: Monitor user sessions, ensuring they align with the validity of the access tokens.

Using Data with Hyper

Once Hyper Connect is configured:

1. Tagging and Querying: Employ Hyper's API to tag and query the connected data.

2. Webhooks: If needed, configure webhooks to get real-time notifications for certain events in the Slack workspace.