【Python】ChatworkでAPIを使って自動的にメッセージを送る

Pythonでバッチを組むと、処理結果やエラーをどこかに通知したくなります、メールだと埋もれがちなので、チャットに飛ばしておくと見落としが減って便利です

通知先としてよく挙がるLINEやメールは、最近ちょっとハードルが上がっています、LINEは手軽だったLINE Notifyが2025年3月で終了して、今はメッセージ送信にLINE公式アカウントの用意が必要になりました、メールも安定して送ろうとすると外部サービスの契約が要りがちです

その点Chatworkは、アカウントさえあればAPIトークンとルームIDの2つを用意するだけでPythonから数行でメッセージを送れます、この記事ではその2つの取得方法から、実際に送るサンプルコードまでまとめてご紹介します

APIの利用に必要なもの

プログラムのなかで使うパラメータは次の2つです

• APIトークン(誰として送るか=送信元アカウントの鍵)
• ルームID(どのチャットに送るか=宛先)

それぞれの取得方法を順番に見ていきます

APIトークンを取得

STEP

サービス連携を開く

ログイン後、右上のアカウント名をクリックして、メニューの中からサービス連携をクリックします

STEP

APIトークンをコピーする

ChatworkのWEBページに移動するので、左側のメニューでAPIトークンをクリックします、トークンが表示されるのでコピーして控えておきます

ルームIDを取得

次は、メッセージを送りたいルームのルームIDを調べます

STEP

対象のグループチャットを開く

通知の対象にするグループチャットをクリックして、アクティブな状態にしておきます

STEP

グループチャットの設定を開く

右上の歯車アイコンをクリックして、グループチャットの設定をクリックします

STEP

ルームIDを控える

設定画面の左下にルームIDが表示されているので、控えておきます

Pythonのプログラム

肝心のPythonプログラムがこちらです、APIトークンとルームIDはコードに直書きせず、.envファイルから読み込む形にしています、こうしておけば値を差し替えるのも楽ですし、うっかり鍵を公開してしまう事故も防げます

まず読み込みに使うpython-dotenvを入れておきます

pip install python-dotenv

次にプロジェクトの直下に.envを作って、さっき取得したAPIトークンとルームIDを書いておきます

CHATWORK_TOKEN=取得したAPIトークン
CHATWORK_ROOM_ID=取得したルームID

本体のコードがこちらです、ステータスコードが200かどうかで送信成功をTrue・Falseで返すようにしています

import os

import requests
from dotenv import load_dotenv

load_dotenv()
CHATWORK_TOKEN = os.environ["CHATWORK_TOKEN"]
CHATWORK_ROOM_ID = os.environ["CHATWORK_ROOM_ID"]


def send_to_chatwork(message, chatwork_token=CHATWORK_TOKEN, room_id=CHATWORK_ROOM_ID) -> bool:
    url = f"https://api.chatwork.com/v2/rooms/{room_id}/messages"
    headers = {
        "accept": "application/json",
        "content-type": "application/x-www-form-urlencoded",
        "x-chatworktoken": chatwork_token,
    }
    payload = {
        "self_unread": 0,
        "body": message,
    }
    response = requests.post(url, data=payload, headers=headers)
    return response.status_code == 200

やっていることはシンプルで、https://api.chatwork.com/v2/rooms/{room_id}/messages に対して、ヘッダーにX-ChatWorkToken(取得したAPIトークン)を入れて、bodyにメッセージ本文を入れてPOSTするだけです、self_unreadは自分側を未読にするかどうかの任意指定で、0だと既読の状態で送られます

あとは send_to_chatwork(‘通知したいメッセージ’) のように呼べば、バッチの好きなタイミングで通知できます

通知結果

↓のように、APIトークンを発行したアカウントとしてメッセージが送信されます

公式ドキュメント

公式ドキュメントはいくつかありますが、↓のページは簡易テストもできてわかりやすいです

メッセージを投稿する｜Chatwork API Documentation

あとがき

仕事で処理結果やエラーを共有するなら、Chatworkは利用シーンが多いので作っておくと便利です

Pythonの自動化つながりだと、Selenium WebDriverWaitの使い方でスクレイピングを安定させて、その結果をこのChatwork通知に流す、といった組み合わせも便利です

作ったスクリプトを配りたいときは、PyInstallerでexe化する話もあわせてどうぞ

📚 Python自動化の独学に効く本PR

退屈なことはPythonにやらせよう 第3版

Al Sweigart

Amazonで見る楽天で見る

シゴトがはかどる Python自動処理の教科書

クジラ飛行机

Amazonで見る楽天で見る

もっとシゴトがはかどる Python×Excel×AI 業務自動化の教科書

クジラ飛行机

Amazonで見る楽天で見る

私のおすすめからランダムで3冊を表示しています