Skip to main content

​
Overview

Junis Slack Integration brings the power of AI directly into your team’s Slack workspace. Once connected, you can:
  • Chat with Junis - Mention @Junis in any channel or send direct messages
  • Access Multiple Organizations - Switch between different Junis organizations using a simple pattern
  • Maintain Conversation Context - Junis remembers your conversation history within threads
  • Real-time Streaming - Get instant, streaming responses directly in Slack
Slack mention example

Junis responds to @mentions in Slack channels

​
Quick Start

​
Step 1: Add Junis to Your Workspace

1

Go to Installation Page

Visit junis.ai/slack while logged into your Junis account.
You must be logged in and belong to at least one Junis organization to install the Slack app.
2

Click 'Add to Slack'

Click the Add to Slack button to begin the OAuth authorization process.
3

Authorize Permissions

Review and approve the requested permissions in the Slack authorization screen:
  • Send messages as Junis
  • View messages in channels where Junis is mentioned
  • Receive direct messages
4

Link Your API Key

After authorization, you’ll be redirected to a success page. Enter your Junis API Key to complete the setup.
Don’t have an API key? Go to Admin → API Keys in Junis to create one.

​
Step 2: Start Chatting

Once installed, you can interact with Junis in two ways:

Channel Mentions

Type @Junis followed by your message in any channel where Junis is added.
@Junis What's the latest sales report?

Direct Messages

Send a direct message to the Junis app for private conversations.
Create a summary of our Q4 objectives

​
Multi-Organization Support

If you belong to multiple Junis organizations, you can specify which organization to use by including the organization name in asterisks: 
@Junis *TooEasy* What are our pending tasks?
Format: *OrganizationName* your message hereThe organization name should match exactly as it appears in your Junis account (case-sensitive).

​
How It Works

  1. No organization specified → Uses the default organization linked during setup
  2. Organization specified → Uses the specified organization for that message
  3. Invalid organization → Falls back to the default organization

​
Thread Conversations

Junis maintains conversation context within Slack threads. When you reply in a thread:
  • Previous messages are included - Up to 20 recent messages in the thread
  • Context is preserved - Follow-up questions work naturally
  • Each thread is independent - Different threads have separate contexts
You: @Junis What's our Q4 revenue?
Junis: Your Q4 revenue was $2.4M, a 15% increase from Q3...

You: (in thread) What were the top contributing products?
Junis: Based on the Q4 data I just mentioned, the top products were...

​
Managing Your Integration

​
View Connected Workspaces

  1. Go to Junis Admin Dashboard
  2. Navigate to Team Settings → Slack Integrations
  3. View all connected Slack workspaces for your organization
1

Access Slack Settings

In Junis Admin, go to Team Settings → Slack Integrations
2

Find Your Workspace

Locate the Slack workspace you want to update
3

Enter New API Key

Click Link API Key and enter your new or updated API key
If you revoke or delete your API key, the Slack integration will stop working. Make sure to link a new valid API key.

​
Remove Integration

To disconnect Junis from your Slack workspace:
  1. Go to Team Settings → Slack Integrations in Junis Admin
  2. Click Remove next to the workspace you want to disconnect
  3. Confirm the removal
Removing the integration will:
  • Stop Junis from responding to mentions and DMs
  • Delete the stored OAuth tokens
  • Keep your conversation history in Junis

​
Best Practices

Provide context in your questions for better responses:✅ Good: @Junis What were our top 5 selling products in December 2024?❌ Less effective: @Junis What sold well?
Reply in threads to maintain context and keep channels organized:
  • Start a new message for unrelated topics
  • Reply in thread for follow-up questions
  • Junis remembers up to 20 messages in the thread
If you work with multiple organizations, explicitly specify which one:
@Junis *ClientCo* What's the status of Project Alpha?
Make sure Junis is invited to channels where you want to use it:
  1. Open the channel
  2. Type /invite @Junis
  3. Junis can now respond to mentions in that channel

​
Security & Privacy

OAuth 2.0 Authentication

Industry-standard secure authentication protocol with CSRF protection.

AES-256 Encryption

All access tokens are encrypted at rest using AES-256 encryption.

Per-Organization Isolation

Each organization’s data is isolated and cannot be accessed by others.

API Key Authorization

Only messages from workspaces with valid API keys are processed.

​
Data Handling

Data TypeStorageAccess
Slack messagesNot stored by JunisReal-time processing only
Conversation historyStored in JunisUsed for context
OAuth tokensEncrypted storageAutomatic refresh
User identifiersStored for session managementNo personal data shared

​
Troubleshooting

Possible causes:
  • Junis is not invited to the channel
  • API key is not linked or has been revoked
  • The mention format is incorrect
Solutions:
  1. Invite Junis: /invite @Junis
  2. Check API key in Admin → Team Settings → Slack Integrations
  3. Use the exact format: @Junis your message
Cause: The organization name in *OrgName* doesn’t match any of your organizations.Solution: Check the exact organization name in your Junis account settings.
Possible causes:
  • Complex queries requiring more processing time
  • Network connectivity issues
Solutions:
  1. For complex requests, wait a bit longer (up to 30 seconds)
  2. Check your internet connection
  3. Try breaking down complex questions into simpler ones
Steps:
  1. Remove the integration from Junis Admin
  2. Visit junis.ai/slack
  3. Click “Add to Slack” and complete the authorization
  4. Link your API key

​
API Key Scopes

When linking an API key to your Slack integration, ensure it has the appropriate scopes:
ScopeDescriptionRequired
orchestrator:invokeSend messages to Junis AI✅ Yes
orchestrator:streamEnable real-time streaming responses✅ Yes
sessions:readView conversation history✅ Yes
sessions:messagesAccess session messages✅ Yes
When you create an API key in Junis Admin, all required scopes are automatically included.

​
Need Help?

Contact Support

Email our support team for personalized assistance.

Documentation

Browse our full documentation for more guides and tutorials.