邮件批量发送脚本

• 参数配置
• 安装流程
• 使用说明
• 可选功能

参数配置

配置批处理文件 (.bat) 时可以选择传入的参数。

留空使用默认设定值。

usage: main.py [-h] [--column-address COLUMN_ADDRESS] [--column-name COLUMN_NAME] [--column-code COLUMN_CODE] [--column-pays COLUMN_PAYS]
               [--column-sent COLUMN_SENT] [-a ADDRESS] [-p PASSWORD] [-t TIMEOUT] [-i INTERVAL] [-r ATTEMPTS]
               [url]

Bulk Email Sending（邮件批量发送脚本）

positional arguments:
  url                             邮箱网页端链接

options:
  -h, --help                      打印帮助信息并退出
  --column-address COLUMN_ADDRESS 字段“邮箱”列名称
  --column-name COLUMN_NAME       字段“主要联系人”列名称
  --column-code COLUMN_CODE       字段“客户编号”列名称
  --column-pays COLUMN_PAYS       字段“国家地区”列名称
  --column-sent COLUMN_SENT       字段“已发送”列名称
  -a, --address ADDRESS           邮箱地址
  -p, --password PASSWORD         邮箱密码
  -t, --timeout TIMEOUT           超时时长（秒）；默认值：60
  -i, --interval INTERVAL         间隔时长（秒）；默认值：10
  -r, --attempts ATTEMPTS         允许尝试次数；默认值：3

安装流程

Note

在执行初始化脚本之前请确保 Python 已经正确安装并添加到 PATH 系统变量中。
(在安装向导中勾选 Add Python to PATH 选项)

系统要求

• Windows 10+
• Python 3.10+
• Git for windows
• Windows Terminal（可选）

安装步骤

Tip

在已经安装了 Windows Terminal 的 Windows 11 环境下，右键桌面（或文件资源管理器窗口），在弹出的菜单中可以找到 在终端中打开 的选项，点击可以打开终端。

1. 打开终端，克隆仓库到本地：

git clone https://git.autistic.men/Ultimatron-France/bulk-email-sending-script.git 邮件批量发送

2. 进入 邮件批量发送 文件夹下的 profiles 文件夹，双击运行 setup-virtualenv 批处理文件进行环境初始化。

3. 等待初始化完成，终端显示 Press any key to continue... 时关闭终端。

4. 编辑 profiles 文件夹下的 profile-example 批处理文件，分别将 --address 和 --password 参数对应的值更改为实际使用的邮箱账号密码，保存并退出文本编辑器。这个文件将作为脚本的启动配置文件。

5. （可选）将 profile-example 重命名为实际使用的邮箱账号名称，方便记忆。

使用说明

Note

由于脚本在初始化阶段需要连接到 Google 服务，在运行前请确保 VPN 已打开。

基本操作步骤

1. 准备需要发送的邮件和客户列表。客户列表必须包含 邮箱 字段（表头名称可自定义），并且以 XLSX 格式保存。

2. 双击运行 profiles 文件夹下的启动配置文件，等待脚本初始化（初次运行会自动下载必要文件，需要一段时间）。

3. 脚本初始化完成，此时会打开带有两个标签页（第一个是配置页面，第二个是 IONOS 邮箱页面）的新浏览器实例，自动化程序尝试登录到 IONOS 邮件系统。

4. 登录完成，程序自动跳转到配置页面。在配置页面上单击 Open 按钮，在弹出的对话框中选择需要发送的客户列表，单击 打开 按钮。

5. 客户列表读取完成，程序自动跳转到 IONOS 邮箱页面。单击草稿箱按钮，在左侧列表中勾选需要发送的邮件（不支持多选）。

6. 打开配置页面，按需调整参数配置，单击 Send 按钮，随后立即打开 IONOS 邮箱页面，自动化程序开始运行。

Warning

自动化程序运行时请避免最小化程序窗口、直接关闭窗口或在 IONOS 邮箱页面进行任何操作。

Note

无论是执行 Send 或是 Resume 操作，必须及时打开 IONOS 邮箱页面，否则自动化程序可能无法正常工作。

7. 自动化程序运行时，用户可以打开配置页面，单击页面上的操作按钮执行相应操作。

8. 自动化程序运行结束，程序自动跳转到配置页面，在页面上方有弹窗显示已发送数量、警告数和错误数。此时可关闭程序窗口，或进行下一轮发送操作。

用户界面说明

基本信息 (Basic Information)

显示名称	说明	备注
File Name	文件名称
From	发件人
Progress	当前程序进度（已发送数量）
Uptime	程序运行时长
Status	程序当前状态	Idle, Ready, Running, Standby
Subject	邮件主题
Recipient	收件人
Timezone	当前时区	由 Locale 参数控制
Remaining	待发送数量
Open	打开文件	仅在 Idle 状态下可见
Send	开始发送	仅在 Ready 状态下可见
Pause	暂停	仅在 Running 状态下可见
Resume	恢复	仅在 Standby 状态下可见
Skip	跳过
Cancel	取消

基本参数 (Parameters)

显示名称	说明	备注
Timeout	超时时长	单位：秒
Interval	间隔时长	单位：秒
Max Occurrence	最大允许重复次数	由 Avoid spamming 选项控制
Attempts	操作最大尝试次数
Locale	语言和时区	仅当 Greet recipients 选项启用时有效果
Greet recipients	使用问候语
Enable task slicing	启用任务切片功能
Avoid spamming	避免重复发送
Save to file	保存发送记录	默认启用

列表字段配置 (Columns)

显示名称	说明	备注
Recipient Address	收件人邮箱地址	必填
Recipient Name	收件人名称
Reference Code	客户编号
Country	国家地区
Remarks	发送标记
Variables	自定义变量

任务切片 (Slicing)

显示名称	说明	备注
Group By	分组依据
Chunk Size	块大小	最小值：500
Offset	偏移量	最小值：0
Max	最大值
Subcategory	子类目	由 Group By 选项控制

可选功能

使用问候语 (Greet Recipients)

任务切片 (Task Slicing)

避免重复发送 (Avoid Spamming)

保存发送记录 (Save to File)

列表字段调整