Slack Integration Setup

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

Overview

The Cube2 Slack bot allows your team to:

• Ask questions about the MetrePay 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 (MetrePay or partner workspace)
• A running Cube2 MCP server configured with the MetrePay 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 MetrePay 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 Map a payment link with amount, customer email and name
@Cube2 How do I configure a STATIC subscription?

Example Interactions

Question	Cube2 Response
"Map a single payment link"	Shows attribute mapping for payment link creation
"What's needed for STATIC subscriptions?"	Explains recurrentPayment=true and recurrentPaymentType=STATIC configuration
"Generate mapping for subscription modification"	Provides field mapping table for modify endpoints
"How do I cancel subscription installments?"	Shows cancel-by-amount and cancel-by-invoice mappings