Harmonic Society
オンライン予約 お問い合わせ
プログラミング

【初心者向け】Slack API×Python連携の始め方｜実例コード付きで解説

kento_morota 15分で読めます

Slack APIとPythonの連携で実現できること

「毎日の定型作業に追われて本来の業務に集中できない」――中小企業のIT担当者や経営者から、こうした声をよく伺います。

Slack APIとPythonを連携させることで、日常業務の多くを自動化できます。プログラミング初心者でも、基本的な知識があれば通知の自動送信、データ集約、タスク管理の効率化などを実践できます。

この記事では、Slack API Python 連携の方法を、実際に動くコード例とともに解説します。「何ができるのか」「どう業務に活かせるのか」というビジネス価値を重視し、初心者の方でも迷わず実践できるようステップバイステップでご案内します。

具体的な活用シーンと効果

通知の自動化では、システムやWebサイトで発生したイベントをリアルタイムでSlackに通知できます。ECサイトの新規注文、問い合わせフォームからの連絡、サーバーエラーなど、重要な情報を見逃さずチーム全体で共有できます。

データ集約と報告では、複数のシステムに散らばるデータを定期的に収集し、整形してSlackに投稿することで、資料作成時間を大幅に削減できます。売上速報、在庫状況、顧客対応件数など、経営判断に必要な情報をタイムリーに把握できます。

タスク管理の自動化では、プロジェクトの進捗を自動チェックし、期限が近づいたタスクをメンション通知したり、完了報告を自動集計したりできます。管理者の負担が減り、チームメンバーも報告漏れの心配から解放されます。

実際の導入事例として、製造業では生産ラインの稼働状況をリアルタイム通知、小売業では各店舗の日報を自動集計、サービス業では顧客問い合わせを自動転送する仕組みが活用されています。いずれも大規模なシステム導入ではなく、既存ツールを活かした小さな自動化から始めている点が共通しています。

事前準備：Slack Appの作成とトークン取得

Slack API Python 連携を始めるには、Slack App作成とBot Tokenの取得が必要です。以下の手順で進めます。

Slack Appの作成と権限設定

Step1：Appの作成

  1. https://api.slack.com/appsにアクセスし「Create New App」をクリック
  2. 「From scratch」を選択
  3. App Name（例：「業務通知Bot」）とWorkspaceを選択し「Create App」をクリック

Step2：権限（スコープ）の設定

左側メニュー「OAuth & Permissions」→「Bot Token Scopes」で以下を追加：

  • chat:write：メッセージ送信
  • chat:write.public：未参加のパブリックチャンネルへの送信
  • files:write：ファイルアップロード
  • channels:read：チャンネル情報取得

単純な通知だけならchat:writeのみで十分です。セキュリティの観点から、必要最小限の権限のみを付与してください。

Step3：Bot Tokenの取得

  1. 「OAuth & Permissions」ページ上部の「Install to Workspace」をクリック
  2. 権限を確認し「許可する」をクリック
  3. 表示される「Bot User OAuth Token」（xoxb-で始まる文字列）をコピー

セキュリティ上の重要な注意点：

  • トークンは絶対にGitHubなどに公開しない
  • 環境変数で管理し、コードに直接書かない
  • 漏洩の疑いがある場合はすぐに再生成

Python環境の準備

プロジェクトごとに独立した仮想環境を作成します。

# プロジェクトディレクトリを作成
mkdir slack_project
cd slack_project

# 仮想環境を作成・有効化
python -m venv venv

# Windowsの場合
venv\Scripts\activate
# macOS/Linuxの場合
source venv/bin/activate

プロジェクトルートに.envファイルを作成し、Bot Tokenを記載：

SLACK_BOT_TOKEN=xoxb-your-token-here

.gitignoreに以下を追加：

venv/
.env

slack_sdkのインストールと初期設定

Slack API Python 連携には、公式SDK「slack_sdk」を使用します。従来のslackclientは非推奨のため、必ずslack_sdkを使ってください。

インストールと初期化

pip install slack_sdk python-dotenv

基本的な初期化コード：

import os
from dotenv import load_dotenv
from slack_sdk import WebClient
from slack_sdk.errors import SlackApiError

# 環境変数の読み込み
load_dotenv()
SLACK_BOT_TOKEN = os.environ.get("SLACK_BOT_TOKEN")

# WebClientの初期化
client = WebClient(token=SLACK_BOT_TOKEN)

接続テスト

正しく設定できているか確認します：

try:
    response = client.auth_test()
    print("接続成功！")
    print(f"ボット名: {response['user']}")
    print(f"チームID: {response['team_id']}")
except SlackApiError as e:
    print(f"エラー: {e.response['error']}")

よくあるエラー：

  • invalid_auth：トークンが間違っているか期限切れ
  • token_revoked：トークンが無効化されている
  • not_authed：環境変数が正しく読み込まれていない

実践①：メッセージ送信の基本と応用

シンプルなメッセージ送信

最も基本的なメッセージ送信：

try:
    response = client.chat_postMessage(
        channel="#general",
        text="こんにちは！Pythonからのメッセージです。"
    )
    print("メッセージを送信しました！")
except SlackApiError as e:
    print(f"エラー: {e.response['error']}")

チャンネル名ではなくID（Cで始まる文字列）で指定する方が確実です。IDはSlackアプリでチャンネル名をクリックすると確認できます。

Block Kitで視覚的に分かりやすいメッセージ

業務レポートなど、構造化された情報を送る場合はBlock Kitを活用します：

try:
    response = client.chat_postMessage(
        channel="#general",
        text="日次レポート",
        blocks=[
            {
                "type": "header",
                "text": {
                    "type": "plain_text",
                    "text": "📊 本日の業務レポート"
                }
            },
            {
                "type": "section",
                "fields": [
                    {"type": "mrkdwn", "text": "*売上:*\n¥1,234,567"},
                    {"type": "mrkdwn", "text": "*問い合わせ:*\n23件"}
                ]
            },
            {
                "type": "divider"
            },
            {
                "type": "context",
                "elements": [
                    {"type": "mrkdwn", "text": "自動生成 | 2024年1月15日 18:00"}
                ]
            }
        ]
    )
except SlackApiError as e:
    print(f"エラー: {e.response['error']}")

Block Kit Builderで視覚的にデザインを確認しながら、生成されたJSONをコードにコピーすると効率的です。

メンション機能

特定ユーザーへのメンション：

response = client.chat_postMessage(
    channel="#general",
    text="<@U01234ABCDE> 確認をお願いします！"
)

全員への通知：

response = client.chat_postMessage(
    channel="#general",
    text="<!channel> 重要なお知らせです"
)
  • ：全メンバーに通知
  • ：オンラインメンバーのみに通知

注意：全員通知は使用頻度に注意が必要です。

エラー対処法

channel_not_found：チャンネルが存在しないか、Botが未参加。/invite @ボット名でチャンネルに招待してください。

not_in_channel：chat:write.public権限を追加するか、Botをチャンネルに招待。

missing_scope：必要な権限が不足。Slack App管理画面で権限を追加し、再インストール。

実践②：ファイルアップロードの実装

基本的なファイルアップロード

files_upload_v2メソッドを使用します（従来のfiles_uploadは非推奨）：

try:
    response = client.files_upload_v2(
        channel="#general",
        file="report.pdf",
        title="月次レポート",
        initial_comment="今月のレポートをアップロードしました。"
    )
    print("ファイルをアップロードしました！")
except SlackApiError as e:
    print(f"エラー: {e.response['error']}")

複数チャンネルへの同時送信：

response = client.files_upload_v2(
    channels=["#sales", "#management"],
    file="report.pdf",
    title="重要レポート"
)

形式別の送信例

CSVファイル：

import csv
from io import StringIO

csv_data = StringIO()
writer = csv.writer(csv_data)
writer.writerow(["日付", "売上", "顧客数"])
writer.writerow(["2024-01-15", "1234567", "45"])

response = client.files_upload_v2(
    channel="#data",
    content=csv_data.getvalue(),
    filename="sales_data.csv",
    title="売上データ"
)

Excelファイル：

import pandas as pd

df = pd.DataFrame({
    "商品名": ["商品A", "商品B"],
    "売上": [100000, 150000]
})

excel_file = "temp_report.xlsx"
df.to_excel(excel_file, index=False)

response = client.files_upload_v2(
    channel="#reports",
    file=excel_file,
    title="在庫レポート"
)

os.remove(excel_file)

グラフ画像：

import matplotlib.pyplot as plt

plt.figure(figsize=(10, 6))
plt.plot([1, 2, 3, 4, 5], [10, 25, 30, 45, 50])
plt.title("売上推移")

image_file = "sales_chart.png"
plt.savefig(image_file)
plt.close()

response = client.files_upload_v2(
    channel="#analytics",
    file=image_file,
    title="売上推移グラフ"
)

os.remove(image_file)

大容量ファイルは圧縮してからアップロードすることで、転送時間を短縮できます。

実践③：自動化Botの構築

定期実行でレポートを自動送信

cronやタスクスケジューラーと組み合わせて、定期的にレポートを送信する仕組みを構築できます：

import os
from datetime import datetime
from dotenv import load_dotenv
from slack_sdk import WebClient

load_dotenv()
client = WebClient(token=os.environ.get("SLACK_BOT_TOKEN"))

def send_daily_report():
    # データ取得処理（例）
    sales_total = 1234567
    inquiry_count = 23
    
    client.chat_postMessage(
        channel="#reports",
        blocks=[
            {
                "type": "header",
                "text": {"type": "plain_text", "text": "📊 日次レポート"}
            },
            {
                "type": "section",
                "fields": [
                    {"type": "mrkdwn", "text": f"*売上:*\n¥{sales_total:,}"},
                    {"type": "mrkdwn", "text": f"*問い合わせ:*\n{inquiry_count}件"}
                ]
            },
            {
                "type": "context",
                "elements": [
                    {"type": "mrkdwn", "text": f"自動生成 | {datetime.now().strftime('%Y年%m月%d日 %H:%M')}"}
                ]
            }
        ]
    )

if __name__ == "__main__":
    send_daily_report()

このスクリプトをcron（Linux/Mac）やタスクスケジューラー（Windows）で毎日実行するよう設定します。

Webhookとの使い分け

Incoming Webhookは設定が簡単で、特定チャンネルへの通知専用です。一方、Slack API Python 連携は柔軟性が高く、以下が可能です：

  • 動的にチャンネルを選択
  • ユーザー情報の取得
  • ファイルアップロード
  • メッセージの更新・削除
  • イベントの受信

単純な通知だけならWebhook、複雑な処理が必要ならSlack APIを選択してください。

実務での応用とトラブルシューティング

業務システム連携の実例

問い合わせフォーム通知：

Webサイトの問い合わせフォームから送信があった際、内容をSlackに自動転送します。担当者がすぐに対応でき、対応履歴もスレッドで一元管理できます。

日報収集の自動化：

各店舗や部署からの日報をSlackのフォームで入力し、Pythonで自動集計して本部に報告。Excelファイルのメール添付と比べ、入力ミスや提出漏れが大幅に減少します。

セキュリティのベストプラクティス

  1. トークンの管理：環境変数で管理し、絶対にコードに直接記載しない
  2. 最小権限の原則：必要な権限のみを付与
  3. ログの記録：API呼び出しのログを残し、異常な動作を検知
  4. 定期的な見直し：使用していないAppやトークンは削除

よくあるエラーと解決方法

rate_limited：API呼び出しの頻度制限に達しました。リクエスト間隔を空けるか、バッチ処理を検討してください。

invalid_blocks：Block KitのJSON構造が不正です。Block Kit Builderで構造を確認してください。

file_not_found：指定したファイルパスが存在しません。相対パスではなく絶対パスを使用してください。

まとめ：小さく始めて徐々に拡張する

この記事では、Slack API Python 連携の基本から実践的な活用方法まで解説しました。

学んだ内容の振り返り：

  • Slack Appの作成とBot Token取得
  • slack_sdkを使ったメッセージ送信
  • Block Kitによる視覚的なメッセージ作成
  • ファイルアップロードの実装
  • 定期実行による自動化

推奨する導入ステップ：

  1. まずは通知から：システムやフォームからの通知を1つ自動化
  2. データ集約を追加：日報や売上データの自動集計
  3. 定期実行で効率化：レポート送信やリマインダーを自動化
  4. 双方向の対話へ：Botがメンションに反応する仕組みを構築

大規模なシステム導入ではなく、小さな自動化から始めて着実に効果を実感することが成功のポイントです。

Harmonic Societyでは、中小企業の「ちょうどいい」業務システム開発とAI活用サポートを提供しています。Slack連携を含む業務自動化でお困りの際は、お気軽にご相談ください。

#Slack#Python#API
共有:

関連記事

【初心者向け】AWS Lambdaの使い…

【初心者向け】AWS Lambdaの使い方を基礎から解説｜実践で使える設定手順
【Docker入門】初心者でも安心！基礎…

【Docker入門】初心者でも安心！基礎から実践まで丁寧に解説
【初心者向け】Docker Compos…

【初心者向け】Docker Compose の使い方｜基本から実践まで丁寧に解説

ちょっとした業務の悩みも、気軽にご相談ください。

まずは話だけ聞いてもらう