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

はじめに

Square Cloud でを開発してホストするには、構成と前提条件の体系的な手順に従うことが不可欠です。この技術ガイドでは、初期セットアップから本番環境へのデプロイまで、プロセス全体を解説します。

前提条件

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

プロジェクトの作成

Slack ボットを作成するには、Slack でアプリを作成するためのアカウントと権限が必要です。次の手順に従う前に、https://slack.com/ でアカウントを作成またはアクセスしてください。

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

Slack API - Your Apps にアクセスし、「Create New App」をクリックします。
「From scratch」を選択し、アプリに名前を付け、インストールする workspace を選択します。
(「Basic Information」にある) Signing Secret をメモし、「OAuth & Permissions」セクションで Bot Token を作成して、ボットに適切なスコープ (例: chat:write、channels:read、commands、app_mentions:read) を追加します。

セキュリティ: Signing Secret や Bot Token を公開しないでください。これらは機密性の高い認証情報として扱ってください。

プロジェクトの開発

選択する言語に応じて、以下のセクションを使用してください。どちらの例も、メンションや簡単なコマンドに応答するボットを示しています。

Node.js - @slack/bolt
Python - slack_bolt

Node.js 環境のセットアップ

Node.js がインストールされていることを確認してください。
プロジェクトを初期化し、依存関係をインストールします。

Terminal

npm init -y
npm install @slack/bolt

次の内容の index.js ファイルを作成します。

index.js

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

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

// 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(process.env.PORT || 3000);
  console.log('⚡️ Slack Bolt app is running!');
})();

注意: Square Cloud では、アプリケーションパネルで環境変数 SLACK_SIGNING_SECRET と SLACK_BOT_TOKEN を設定してください。

Python 環境のセットアップ

Python と pip がインストールされていることを確認してください。
Bolt for Python ライブラリをインストールします。

Terminal

pip install slack_bolt

次の内容の app.py ファイルを作成します。

app.py

from slack_bolt import App
import os

app = App(
    signing_secret=os.environ.get('SLACK_SIGNING_SECRET'),
    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 mention!')

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

if __name__ == '__main__':
    app.start(port=int(os.environ.get('PORT', 3000)))

Python プロジェクトの場合は、次の内容の requirements.txt を含めます。

requirements.txt

slack_bolt

デプロイ

プロジェクトファイルの準備ができたら、それらを Square Cloud にアップロードしてプロジェクトをホストできます。そのためには、すべてのプロジェクトファイルを含む ZIP ファイルを作成してください。

ダッシュボード経由

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

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

環境を設定

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

プロジェクトをデプロイ

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

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

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

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

CLI 経由

この方法を使用するには、プロジェクトのルートディレクトリに squarecloud.app という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。

設定ファイルガイド

アプリケーションの環境を定義する squarecloud.app 設定ファイルの作成方法を学びます。

CLI をインストール

まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:

npm install -g @squarecloud/cli

すでにお持ちの場合は、更新することを推奨します。更新するには、ターミナルで次のコマンドを実行してください:

Windows
Linux, macOS, and WSL

squarecloud update

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

認証

次に、認証して他の CLI コマンドを使用するには、こちらで「Request API Key」をクリックして認証キーを取得します。認証キーを取得したら、次のコマンドを実行してください:

squarecloud auth login

プロジェクトをアップロード

最後に、CLI を使用してアプリケーションを Square Cloud にデプロイするには、次のコマンドを実行する必要があります:

squarecloud upload

または、zip を手動で作成した場合は、次を使用できます:

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

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

最初のデプロイは、通常 1 分もかからずに完了します。ターミナルから直接、アプリケーションのステータスとログを確認してください。

squarecloud app status
squarecloud app logs

ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。

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

ボットのテスト

Slack App パネルの「OAuth & Permissions」で、アプリを workspace にインストールします。
ボットが (イベントやコマンド用の) エンドポイントを公開している場合は、「Event Subscriptions」と「Slash Commands」の Request URL を、アプリケーションの公開 URL を指すように設定します (Square Cloud はデプロイ後にドメインを提供します)。
チャンネルでのメンションや /hello コマンドをテストして、応答を検証します。

インストールリンクの例 (client_id を置き換えてください):

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

追加リソース

さらに詳しく知りたい場合は、Slack 公式ドキュメントをご確認ください。

Bolt for JavaScript: https://docs.slack.dev/tools/bolt-js/
Bolt for Python: https://docs.slack.dev/tools/bolt-python/

お問い合わせ

技術的な問題が解決しない場合は、専門のサポートチームがお手伝いします。お問い合わせいただければ、どのような問題でも喜んで解決をサポートいたします — サポートの質の高さも、開発者が Google と Trustpilot で Square Cloud に402 件のレビューで 4.9/5という評価をつけている理由の 1 つです。

チュートリアル

Bots

すぐに使えるプロジェクト

データベース

APIs

ウェブサイト

移行ガイド

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

はじめに

前提条件

プロジェクトの作成

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

プロジェクトの開発

デプロイ

ダッシュボード経由

CLI 経由

設定ファイルガイド

ボットのテスト

追加リソース

お問い合わせ

​はじめに

​前提条件

​プロジェクトの作成

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

​プロジェクトの開発

​デプロイ

​ダッシュボード経由

​CLI 経由

設定ファイルガイド

​ボットのテスト

​追加リソース

​お問い合わせ

はじめに

前提条件

プロジェクトの作成

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

プロジェクトの開発

デプロイ

ダッシュボード経由

CLI 経由

ボットのテスト

追加リソース

お問い合わせ