跳转到内容
无痕工具库 无痕工具库

Hostinger Agentic Mail 使用教程:通过 API 和 Webhook 连接邮箱

Hostinger Agentic Mail 通过 Webhook、REST API、MCP 服务器以及允许/屏蔽列表,将你的邮箱与代码和 AI 智能体连接起来。ChatGPT、Claude、Hermes Agent 等工具可以使用 Agentic Mail 代你读取、起草和发送电子邮件。允许/屏蔽列表让你可以控制每个邮箱允许向哪些地址发送邮件。

什么是 Agentic Mail?

Agentic Mail 是 Hostinger Email 产品中的一项功能,它将你的邮箱开放给代码和 AI 智能体使用。Agentic Mail 在所有 Hostinger Email 方案中均可用。与只能通过桌面客户端收发邮件不同,Agentic Mail 让外部程序能够实时响应收到的邮件、控制邮件可以发送到哪些地址,并通过 REST API 管理整个邮箱的生命周期。

它可以在 Hostinger 控制面板和 Webmail 中使用,目前提供四大构建模块:

  • Webhook —— 事件发生时的实时 HTTP 推送通知
  • Allow/Block lists(允许/屏蔽列表) —— 针对每个邮箱的外发收件人控制
  • API —— 对所有邮箱操作进行程序化 CRUD,支持通过 API 发送/管理和接收电子邮件
  • MCP 服务器 —— 面向 AI 智能体的模型上下文协议(Model Context Protocol)集成

在 Webmail 中,Agentic Mail 只能控制你当前登录邮箱的设置。而在 Hostinger 控制面板中,你可以管理域下任何邮箱的 Agentic Mail 设置。

观看以下视频,了解 Agentic Mail 的实际应用——包括如何在 Hostinger 控制面板中进行设置、通过 MCP 服务器将其连接到 Claude Desktop,以及用它来整理、归类和总结你的收件箱。

观看视频

观看视频

Agentic Mail 适合哪些人?

Agentic Mail 面向开发者、AI 爱好者以及希望让电子邮件成为自动化工作流中活跃一环的具备技术思维的企业主。典型使用场景包括:

  • 构建由 AI 驱动的收件箱助手或分流机器人,在邮件到达的第一时间做出响应
  • 连接 Openclaw 或 Hermes 等 AI 智能体
  • 通过 Webhook 将 Hostinger Email 连接到无代码/低代码平台(n8n、Make、Zapier)
  • 通过 REST API 以编程方式发送事务性邮件(transactional email)并读取回复
  • 控制自动化邮箱的外发邮件范围,防止误发垃圾邮件

在哪里可以找到 Agentic Mail?

你可以从 Hostinger 控制面板或 Webmail 访问 Agentic Mail。

从 Hostinger 控制面板访问:

  1. 在 hpanel.hostinger.com 登录 Hostinger 控制面板
  2. 点击左侧边栏中的 Emails
  3. 选择你要配置邮箱所在的域名
  4. 在次级侧边栏中向下滚动,点击 Agentic mail
  5. 你将进入**概览(Overview)**页面,其中显示所有可用功能

从 Webmail 访问:

  1. 为要配置的邮箱 登录 Webmail
  2. 点击侧边栏中的设置
  3. 点击 Agentic Mail
  4. 你将进入**概览(Overview)**页面,其中显示该邮箱可用的功能

如果你需要管理域下多个邮箱的 Agentic Mail 设置,请使用 Hostinger 控制面板。如果你只需配置当前登录的邮箱,请使用 Webmail。

什么是 Webhook?它在 Agentic Mail 中如何工作?

Webhook 是一种实时 HTTP 推送通知。当你的邮箱上发生已配置的事件(目前为 message.received)时,Hostinger Mail 会立即向指定的 URL 发送包含 JSON 载荷的 HTTP POST 请求。你的服务器或智能体随后可以解析这些数据并采取行动,而无需轮询。

Webhook 使用 Bearer 令牌进行身份验证。你的令牌只会在创建后立即显示一次。请务必在离开页面前将其复制保存——之后将无法再次获取。

如何添加新的 Webhook?

  1. 前往 Agentic mail → Webhooks
  2. 点击 Add webhook 按钮(右上角,紫色)
  3. 从下拉菜单中选择要监控的邮箱
  4. 输入你的 Webhook URL —— 必须是可公开访问的 HTTPS 端点
  5. 触发事件已预先设置为 message.received(目前仅有此事件可用)
  6. 点击 Add webhook 保存

“message.received” 触发事件是什么意思?

message.received 在新邮件到达被监控的邮箱时触发。Hostinger Mail 会在投递后立即发送 POST 请求,因此你的智能体可以实时收到通知——无需 IMAP 轮询。JSON 载荷包含邮件元数据(发件人、主题、截断的正文、时间戳),可用于后续处理。

如何测试我的 Webhook 是否正常工作?

每个 Webhook 行都有一个 Test 按钮。点击它会向你的 URL 发送一个示例 POST 请求,让你验证端点是否能够接收并解析它——而无需发送真实邮件。查看页面底部的 Recent deliveries 表格以了解结果(时间戳、状态和响应时长)。如果失败,请确认你的 URL 可通过公共 HTTPS 访问且返回 200。

如何在不删除 Webhook 的情况下启用或禁用它?

使用每个 Webhook 行右侧的 Active 开关。蓝色/开启 = 处于活动状态并接收事件。灰色/关闭 = 暂停但保留配置。这在服务器维护期间或部署端点新版本时非常有用。

“Regenerate secret” 有什么作用?什么时候该使用它?

每个 Webhook 请求的 Authorization 标头中都包含一个 Bearer 令牌。你的端点可以检查此令牌,以确认请求确实来自 Hostinger Mail。

Regenerate token(在 ⋮ 三点菜单中)会创建新令牌并立即使旧令牌失效。当令牌可能已泄露、拥有访问权限的团队成员离职,或你需要定期轮换令牌时使用。

什么是允许/屏蔽列表?它们如何影响我的邮件?

允许/屏蔽列表控制每个邮箱的外发发送——它们决定了该邮箱允许向哪些地址或域名发送邮件。

  • 允许列表:非空时,该邮箱只能向列表中的地址或域名发送邮件。留空则允许向任何人发送。
  • 屏蔽列表:列表中的地址或域名在发送时会被静默拒绝——对方不会收到邮件,发件人也看不到退信。

你可以向任一列表中添加单个地址(name@domain.com)或整个域名(domain.com)。列表是按邮箱划分的——使用页面顶部的下拉菜单进行切换。

如果某个地址同时出现在允许列表和屏蔽列表中会怎样?

屏蔽列表始终优先。如果某个地址(或其域名)同时出现在两个列表中,该邮件将被静默拒绝。这样可以防止宽泛的允许条目(例如整个 example.com)意外覆盖针对特定地址的屏蔽。你也可以屏蔽整个域名(例如 example.com),但同时允许 peter@example.com。

使用 Agentic Mail REST API 可以做什么?

Hostinger Mail REST API 让你能够以编程方式完全控制你的邮箱。使用有效令牌,你的应用程序可以:

  • 管理所有 SMTP/IMAP 操作 —— 发送邮件、读取邮件、管理文件夹、标记为已读、移动、删除
  • 管理 Webhook —— 创建、更新、删除和列出 Webhook 配置

该 API 遵循 REST 规范,接受并返回 JSON。完整文档可通过 API 文档获取。

如何创建 API 令牌?

  1. 前往 Agentic mail → API
  2. 点击 Create API token(右上角)
  3. 输入具有描述性的令牌名称(例如 my-agent-prod)
  4. 选择邮箱访问权限:All mailboxes(所有当前和未来的邮箱)或 Selected mailboxes(仅特定地址)
  5. 查看权限:Manage all SMTP/IMAP actions + Manage webhooks
  6. 点击 Create token 并立即复制令牌——它只会显示一次

“All mailboxes” 和 “Selected mailboxes” 权限范围有什么区别?

  • All mailboxes —— 可访问所有当前邮箱以及未来添加的任何邮箱。最适合管理员级别或全账户范围的自动化。
  • Selected mailboxes —— 仅限于你勾选的特定邮箱。最适合第三方集成(遵循最小权限原则)。

什么是 MCP 服务器?

MCP 服务器(Model Context Protocol,模型上下文协议)现已上线。AI 智能体可以通过 MCP 与 Hostinger Mail 交互,使 Claude 和 Cursor 等框架能够通过你的 Hostinger 邮箱读取、发送和管理电子邮件——无需编写自定义 REST 集成代码。

要访问它,请前往 Hostinger 控制面板 → Emails → [你的域名] → Agentic mail → MCP Server。设置指南可直接在 Hostinger 控制面板中查看。

对于 Claude,你可以跳过手动 MCP 配置,直接从 Claude 目录中的官方 Hostinger Mail 连接器进行连接,地址为 claude.ai/directory/connectors/hostinger-mail。这是将 Hostinger Mail 连接到 Claude 的最快方式,因为授权通过 Claude 的连接器流程完成,而无需手动设置。

对于其他兼容 MCP 的平台或更高级的配置,目前的设置仍需要一定的技术知识。受支持的 AI 平台将不断增加。完整的 API 文档可在 api.mail.hostinger.com 获取。

观看以下视频,更全面地了解 Agentic Mail,包括将其连接到 ChatGPT 以起草回复、使用 Hermes Agent 运行后台自动化,以及使用允许/屏蔽列表进行发送控制。

观看视频

观看视频

其他资源