Slack Integration Setup

Connect Cube2 to your Slack workspace for real-time collaboration during Belmoney integration projects.

Overview

The Cube2 Slack bot allows your team to:

• Ask questions about the Belmoney API directly in Slack
• Generate mapping code and type definitions
• Get integration checklists and examples
• Collaborate on integration issues in real-time

Prerequisites

Before you begin, ensure you have:

• A Slack workspace (Belmoney or partner workspace)
• A running Cube2 MCP server configured with the Belmoney project
• Admin access to create Slack apps in your workspace

Step 1: Create a Slack App

1. Go to api.slack.com/apps
2. Click Create New App
3. Choose From scratch
4. Name your app (e.g., "Cube2 Belmoney Bot")
5. Select your workspace

Step 2: Configure Bot Permissions

Navigate to OAuth & Permissions and add these Bot Token Scopes:

Scope	Purpose
app_mentions:read	Receive notifications when the bot is mentioned
chat:write	Send messages in channels and conversations
groups:history	Read message history in private channels
im:history	Read message history in direct message conversations
im:write	Send messages in direct message conversations
channels:history	Read message history in public channels
channels:read	View basic information about public channels
chat:write.customize	Customize message appearance and formatting
groups:read	View basic information about private channels
im:read	View basic information about direct message conversations
links:read	View links shared in conversations
mpim:read	View basic information about multi-person direct messages
mpim:write	Send messages in multi-person direct messages

Step 3: Enable Socket Mode (Recommended)

Socket Mode allows your bot to receive events without a public URL.

1. Go to Socket Mode in your app settings
2. Enable Socket Mode
3. Create an App-Level Token with connections:write scope
4. Save the token as SLACK_APP_LEVEL_TOKEN

Step 4: Subscribe to Events

Navigate to Event Subscriptions:

1. Enable Events
2. Subscribe to bot events:
   • app_mention
   • message.im
   • message.channels

Step 5: Install to Workspace

1. Go to Install App
2. Click Install to Workspace
3. Authorize the permissions
4. Copy the Bot User OAuth Token

Step 6: Configure Environment Variables

Share the following with Palomonte Labs technical team:

Variable	Location
SLACK_BOT_TOKEN	OAuth & Permissions → Bot User OAuth Token
SLACK_SIGNING_SECRET	Basic Information → App Credentials → Signing Secret
SLACK_APP_LEVEL_TOKEN	Basic Information → App-Level Tokens

Step 7: Start the Bot

This step is done by Palomonte Labs.

Usage

Once configured, interact with Cube2 in Slack:

You can mention the bot in a channel or talk directly with it in the App chat ( as a direct message )

@Cube2 How do I format the sender address for PreRegister?
Generate TypeScript types for the RemittanceTransfer response

Example interactions

Question	Cube2 Response
"What fields are required for PreRegister?"	Lists required fields with types
"Generate a mapping function for sender data"	Provides TypeScript/JS code
"Show me the send payment flow"	Explains PreRegister → Confirm → Status