pywin32でOutlookを操作してメールを自動送信する方法

はじめに
本文へのデータ差し込み処理を実装する｜.format()の活用
1. row.to_dict()で項目追加にも対応できる設計に
pywin32でOutlookを操作してメールを送信する
1. ここまでで実現できる自動化フロー
2. 実用化に向けて加えた機能｜ブログ版と販売版の違い
■ 販売版との主な違い
■ 最後に：エンジニアの挑戦
NINJIN Mailシリーズはこちら
シリーズ記事一覧

はじめに

こんにちは、ニンジンです🥕

全3回でお届けしているメール自動化の開発記も、今回が最終回です。

前回までは、ファイルを選択して場所を記憶する仕組みを作り、操作の土台を整えてきました。今回は、その土台の上に中核機能を実装します。具体的には、以下の2つです。

メール本文を自動生成する「差し込み処理」.format()
Outlookを操作してメール送信まで行う「自動化処理」pywin32

本文へのデータ差し込み処理を実装する｜.format()の活用

GUIで入力したテンプレートに対して、Excelのデータを差し込む処理を作成します。例えば、GUI側で「{氏名} 様」という雛形を用意しておき、そこにExcelの「山田太郎」といったデータを当てはめるイメージです。

このような文字の差し込みは、Pythonの文字列操作メソッド.format()で実現できます。テンプレートとデータを組み合わせることで、メール本文を自動生成します。

氏名、アドレス、会社名のデータは
第１回と同じExcelファイルを使用します。

サンプルコード mail-soft-test04.pyはこちらをクリック

import pandas as pd
import tkinter as tk
from tkinter import filedialog, scrolledtext, messagebox
import os
import json

CONFIG_FILE = "config.json"

# --- 設定ファイルの読み書き（前回パスの取得用） ---
def load_config():
    if os.path.exists(CONFIG_FILE):
        with open(CONFIG_FILE, "r", encoding="utf-8") as f:
            return json.load(f)
    return {"last_path": "", "last_file": "未選択"}

def save_config(file_path):
    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
        json.dump({"last_path": os.path.dirname(file_path), "last_file": file_path}, f, ensure_ascii=False, indent=4)

# --- メインGUIクラス ---
class MailerApp:
    def __init__(self, root):
        self.root = root
        self.root.title("展示会メール作成ツール Pro")
        self.root.geometry("700x600")

        # 設定読み込み
        config = load_config()
        self.current_file_path = config.get("last_file", "未選択")

        # 1. ファイル選択エリア
        file_frame = tk.LabelFrame(self.root, text=" 1. 名簿ファイルの指定 ", padx=10, pady=10)
        file_frame.pack(padx=20, pady=10, fill="x")

        self.lbl_path = tk.Label(file_frame, text=f"現在のファイル: {self.current_file_path}", fg="blue", wraplength=500, justify="left")
        self.lbl_path.pack(side="left", padx=5)

        btn_select = tk.Button(file_frame, text="ファイル変更", command=self.select_file)
        btn_select.pack(side="right")

        # 2. 本文入力エリア
        body_frame = tk.LabelFrame(self.root, text=" 2. 本文雛形の作成 ", padx=10, pady=10)
        body_frame.pack(padx=20, pady=10, fill="both", expand=True)

        tk.Label(body_frame, text="{氏名} {会社名} が自動で置換されます").pack(anchor="w")
        self.txt_body = scrolledtext.ScrolledText(body_frame, font=("MS Gothic", 10), height=15, undo=True)
        self.txt_body.pack(fill="both", expand=True, pady=5)
        
        default_text = "{会社名}\n{氏名} 様\n\n昨日はありがとうございました。"
        self.txt_body.insert(tk.END, default_text)

        # 3. 操作ボタンエリア
        btn_frame = tk.Frame(self.root)
        btn_frame.pack(pady=20)

        self.btn_exec = tk.Button(btn_frame, text=" 一括作成（テスト出力） ", command=self.execute, bg="#0078d4", fg="white", width=25, height=2)
        self.btn_exec.pack(side="left", padx=10)

        self.btn_quit = tk.Button(btn_frame, text=" 終了 ", command=self.root.destroy, width=10, height=2)
        self.btn_quit.pack(side="left", padx=10)

    def select_file(self):
        config = load_config()
        initial_dir = config.get("last_path", os.path.expanduser("~"))
        
        file_path = filedialog.askopenfilename(title="Excelを選択", initialdir=initial_dir, filetypes=[("Excel", "*.xlsx")])
        
        if file_path:
            self.current_file_path = file_path
            self.lbl_path.config(text=f"現在のファイル: {file_path}")
            save_config(file_path)

    def execute(self):
        if not os.path.exists(self.current_file_path):
            messagebox.showerror("エラー", "Excelファイルが選択されていないか、存在しません。")
            return

        template = self.txt_body.get("1.0", tk.END).strip()
        
        try:
            df = pd.read_excel(self.current_file_path)
            print("\n" + "="*50 + "\n 送信プレビュー \n" + "="*50)
            for _, row in df.iterrows():
                print(f"TO: {row['アドレス']}")
                print(template.format(**row.to_dict()))
                print("-" * 30)
            messagebox.showinfo("完了", f"{len(df)}件のプレビューをターミナルに出力しました。")
        except Exception as e:
            messagebox.showerror("エラー", f"処理に失敗しました:\n{e}")

if __name__ == "__main__":
    root = tk.Tk()
    app = MailerApp(root)
    root.mainloop()

※VSCodeなどのエディターにてサンプルコードを実行して下さい

コードを実行すると、画像のGUIが立ち上がります。
右上の「ファイル変更」をクリック

Windowが立ち上がります。
対象のExcelファイルを選択し、「開く」をクリック

ファイルが選択されGUIへ戻ります。
一括作成(テスト出力)を押下すると、本文内に記載されている下記の表示箇所にExcelデータが差し込まれます。
{会社名}
{氏名}

出力に成功すると「完了」のダイアログが表示されます

VSCodeのターミナルにて出力されれば成功です！

row.to_dict()で項目追加にも対応できる設計に

差し込み処理を作る際、「項目が増えるたびにプログラムを書き直す必要がある」という問題が出てきます。例えば「役職」や「部署名」といった列をExcelに追加するたびに、コードを修正するのは手間です。

そこで活用したのがrow.to_dict()です。これを使うと、Excelの1行分のデータを「項目名＝値」のセットとしてまとめて扱えます。結果として、テンプレート側に{役職}や{部署名}と記述するだけで、対応するデータが自動的に差し込まれます。

つまり、Excelの列を増やしてもプログラム側の修正は不要になり、メンテナンス性の高い設計になります。

pywin32でOutlookを操作してメールを送信する

ここでは、メール送信の自動化を実装します。使用するのはpywin32です。これにより、PythonからOutlookを直接操作できるようになります。

今回のポイントは、これまで作ってきたexecuteメソッドの中身を、実際のOutlook操作に置き換えることです。処理の流れ自体は変えず、中身だけを実際の送信処理に差し替えるイメージです。

Outlookの操作自体は比較的シンプルで、想定していたよりも少ないコードで実装できます。

サンプルコード mail-soft-test05.pyはこちらをクリック

import pandas as pd
import tkinter as tk
from tkinter import filedialog, scrolledtext, messagebox
import os
import json
import win32com.client  # Outlook操作用
import time

CONFIG_FILE = "config.json"

def load_config():
    if os.path.exists(CONFIG_FILE):
        with open(CONFIG_FILE, "r", encoding="utf-8") as f:
            return json.load(f)
    return {"last_path": "", "last_file": "未選択"}

def save_config(file_path):
    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
        json.dump({"last_path": os.path.dirname(file_path), "last_file": file_path}, f, ensure_ascii=False, indent=4)

class MailerApp:
    def __init__(self, root):
        self.root = root
        self.root.title("展示会メール作成ツール Pro")
        self.root.geometry("700x600")

        config = load_config()
        self.current_file_path = config.get("last_file", "未選択")

        # 1. ファイル選択
        file_frame = tk.LabelFrame(self.root, text=" 1. 名簿ファイルの指定 ", padx=10, pady=10)
        file_frame.pack(padx=20, pady=10, fill="x")
        self.lbl_path = tk.Label(file_frame, text=f"現在のファイル: {self.current_file_path}", fg="blue", wraplength=500, justify="left")
        self.lbl_path.pack(side="left", padx=5)
        btn_select = tk.Button(file_frame, text="ファイル変更", command=self.select_file)
        btn_select.pack(side="right")
        
        # 2. 件名入力エリア
        subject_frame = tk.LabelFrame(self.root, text=" 2. 件名の入力 ", padx=10, pady=10)
        subject_frame.pack(padx=20, pady=10, fill="x")

        tk.Label(subject_frame, text="件名を入力してください").pack(anchor="w")
        self.txt_subject = tk.Entry(subject_frame, font=("MS Gothic", 10), width=50)
        self.txt_subject.pack(side="left", padx=5)

        # 3. 本文入力エリア
        body_frame = tk.LabelFrame(self.root, text=" 3. 本文雛形の作成 ", padx=10, pady=10)
        body_frame.pack(padx=20, pady=10, fill="both", expand=True)
        tk.Label(body_frame, text="{氏名} {会社名} が自動で置換されます").pack(anchor="w")
        self.txt_body = scrolledtext.ScrolledText(body_frame, font=("MS Gothic", 10), height=15, undo=True)
        self.txt_body.pack(fill="both", expand=True, pady=5)
        
        default_text = "{会社名}\n{氏名} 様\n\n昨日はありがとうございました。"
        self.txt_body.insert(tk.END, default_text)

        # 4. 操作ボタン
        btn_frame = tk.Frame(self.root)
        btn_frame.pack(pady=20)
        # 初期状態は青
        self.btn_exec = tk.Button(btn_frame, text=" 一括作成（実行） ", command=self.execute, bg="#0078d4", fg="white", width=25, height=2)
        self.btn_exec.pack(side="left", padx=10)
        self.btn_quit = tk.Button(btn_frame, text=" 終了 ", command=self.root.destroy, width=10, height=2)
        self.btn_quit.pack(side="left", padx=10)

    def select_file(self):
        config = load_config()
        initial_dir = config.get("last_path", os.path.expanduser("~"))
        file_path = filedialog.askopenfilename(title="Excelを選択", initialdir=initial_dir, filetypes=[("Excel", "*.xlsx")])
        if file_path:
            self.current_file_path = file_path
            self.lbl_path.config(text=f"現在のファイル: {file_path}")
            save_config(file_path)
            # ファイルを変えたらボタンの色を戻す
            self.reset_button()

    def reset_button(self):
        self.btn_exec.config(text=" 一括作成（実行） ", state="normal", bg="#0078d4", fg="white")

    def execute(self):
        if not os.path.exists(self.current_file_path):
            messagebox.showerror("エラー", "Excelファイルが選択されていません。")
            return

        # ボタンを「送信中」状態にする（黄色・無効化）
        self.btn_exec.config(text="送信中...", state="disabled", bg="#ffc107", fg="black")
        self.root.update()

        template = self.txt_body.get("1.0", tk.END).strip()
        
        try:
            # Outlookの起動
            outlook = win32com.client.Dispatch("Outlook.Application")
            df = pd.read_excel(self.current_file_path)
            
            count = 0
            for _, row in df.iterrows():
                # メール作成
                mail = outlook.CreateItem(0)
                mail.to = row['アドレス']
                mail.Subject = self.txt_subject.get().strip() or "（件名なし）"
                
                # 差し込み処理
                mail.Body = template.format(**row.to_dict())
                
                # 送信（テスト時は .Display() に変えると画面が立ち上がるだけで止まる）
                mail.Send() 
                count += 1
                time.sleep(0.5) # 連続送信による負荷軽減

            # 完了状態にする（緑色）
            self.btn_exec.config(text=f"送信完了（{count}件）", state="normal", bg="#28a745", fg="white")
            messagebox.showinfo("完了", f"全 {count} 件の送信を完了しました。\nOutlookの送信済みアイテムを確認してください。")

        except Exception as e:
            self.reset_button()
            messagebox.showerror("エラー", f"処理に失敗しました:\n{e}")

if __name__ == "__main__":
    root = tk.Tk()
    app = MailerApp(root)
    root.mainloop()