Slack ボットをホストする方法

​

はじめに

​

前提条件

• Square Cloud アカウント: 登録ページからメールアドレスを使って登録します。
• 有効なプラン: アプリケーションに専用リソースと最適化されたパフォーマンスを提供します。利用可能なプランを確認し、ニーズに最も適したものを選択してください。

​

プロジェクトの作成

​

Slack でのボットアプリケーション

1. Slack API - Your Apps にアクセスし、「Create New App」をクリックします。
2. 「From scratch」を選択し、アプリに名前を付け、インストールする workspace を選択します。
3. 「Socket Mode」セクションで Socket Mode を有効にし、connections:write スコープを持つ app-level token を生成します。これをコピーしてください (xapp- で始まります)。これが SLACK_APP_TOKEN です。
4. 「OAuth & Permissions」セクションで、ボットに必要なスコープ (例: chat:write、app_mentions:read、commands) を追加し、アプリを workspace にインストールして Bot User OAuth Token をコピーします (xoxb- で始まります)。これが SLACK_BOT_TOKEN です。
5. 「Event Subscriptions」でイベントを有効にし、app_mention ボットイベントをサブスクライブします。「Slash Commands」で /hello コマンドを作成します。Socket Mode が有効なので、どちらも Request URL は不要です。

​

プロジェクトの開発

npm init -y
npm install @slack/bolt

const { App } = require('@slack/bolt');

const app = new App({
  token: process.env.SLACK_BOT_TOKEN,
  appToken: process.env.SLACK_APP_TOKEN,
  // Socket Mode: the bot connects to Slack, so no public URL is needed
  socketMode: true,
});

// Responds when mentioned
app.event('app_mention', async ({ event, say }) => {
  await say(`<@${event.user}> Thanks for mentioning me!`);
});

// Example slash command
app.command('/hello', async ({ ack, respond }) => {
  await ack();
  await respond('Hello from Square Cloud!');
});

(async () => {
  await app.start();
  console.log('⚡️ Slack Bolt app is running!');
})();

pip install slack_bolt

from slack_bolt import App
from slack_bolt.adapter.socket_mode import SocketModeHandler
import os

app = App(token=os.environ.get('SLACK_BOT_TOKEN'))

@app.event('app_mention')
def handle_mention(event, say):
    user = event.get('user')
    say(f'<@{user}> Thanks for mentioning me!')

@app.command('/hello')
def hello_command(ack, respond):
    ack()
    respond('Hello from Square Cloud!')

if __name__ == '__main__':
    # Socket Mode: the bot connects to Slack, so no public URL is needed
    SocketModeHandler(app, os.environ.get('SLACK_APP_TOKEN')).start()

slack_bolt

​

Square Cloud の設定

DISPLAY_NAME=My Slack Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Slack Bot
MAIN=app.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

• MAIN は Square Cloud が実行するファイル、MEMORY はボットの RAM (MB) です。ボットには最低 256 MB が必要で、512 MB あれば成長の余地があります。
• AUTORESTART=true を指定すると、ボットがクラッシュしたときに再起動します。自動再起動の仕組みを参照してください。
• SUBDOMAIN はありません。Socket Mode では、ボットに公開 URL は必要ありません。

​

トークンの設定

• ダッシュボード: アップロードページで Advanced configuration を開き、両方の変数を追加します。すでにデプロイ済みのボットの場合は、アプリケーションの Environment Variables ページで追加し、ボットを再起動します。
• CLI: ボットをアップロードした直後に (デプロイを参照)、squarecloud app env set で設定し、ボットを再起動します。

squarecloud app env set SLACK_BOT_TOKEN=xoxb-your-token SLACK_APP_TOKEN=xapp-your-token
squarecloud app restart

​

デプロイ

​

ダッシュボード経由

1

アップロードページにアクセス

アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。

2

環境を設定

zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。

3

プロジェクトをデプロイ

最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。

4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。

アプリが起動しませんか？よくある原因と修正方法はトラブルシューティングガイドを参照してください。

​

CLI 経由

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

ボットのテスト

1. Slack App パネルの「OAuth & Permissions」で、アプリを workspace にインストールします (まだの場合)。
2. Square Cloud ダッシュボードでアプリケーションのログを開き、起動時のエラーがないか確認します。Socket Mode では設定する Request URL はなく、ボットは起動するとすぐに Slack に接続します。
3. ボットをチャンネルに招待し、メンションするか /hello コマンドを実行して、応答を検証します。

https://slack.com/oauth/v2/authorize?client_id=000000000000.000000000000&scope=commands,chat:write,app_mentions:read

​

Socket Mode の代わりに HTTP モードを使う

1. Slack アプリの設定で Socket Mode を無効にし、(「Basic Information」にある) Signing Secret を環境変数 SLACK_SIGNING_SECRET にコピーします。トークンと同じ方法で設定します。
2. app-level token の代わりに signing secret を使ってアプリを作成し、環境変数 PORT のポートで待ち受けます:

const app = new App({
  token: process.env.SLACK_BOT_TOKEN,
  signingSecret: process.env.SLACK_SIGNING_SECRET,
});

(async () => {
  // Square Cloud sets PORT=80
  await app.start(Number(process.env.PORT) || 80);
  console.log('⚡️ Slack Bolt app is running!');
})();

app = App(
    token=os.environ.get('SLACK_BOT_TOKEN'),
    signing_secret=os.environ.get('SLACK_SIGNING_SECRET')
)

if __name__ == '__main__':
    # Square Cloud sets PORT=80
    app.start(port=int(os.environ.get('PORT', 80)))

3. ボットに公開 URL が割り当てられるように、設定ファイルに SUBDOMAIN を追加します (またはダッシュボードからアップロードする際に「Web Publication」を選択してサブドメインを設定します)。ウェブアプリケーションには少なくとも MEMORY=512 が必要です。

DISPLAY_NAME=My Slack Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true
SUBDOMAIN=my-slack-bot

​

追加リソース

• Bolt for JavaScript
• Bolt for Python

​

次のステップ

​

お問い合わせ