构建 API 让您的营销电子邮件远离垃圾邮件

开展电子邮件营销活动时，最大的挑战之一是确保您的邮件到达收件箱而不是垃圾邮件文件夹。

Apache SpamAssassin 是许多电子邮件客户端和电子邮件过滤工具广泛使用的工具，用于将邮件分类为垃圾邮件。在这篇文章中，我们将探讨如何利用 SpamAssassin 来验证您的电子邮件是否会被标记为垃圾邮件以及为什么会被标记为垃圾邮件。
该逻辑将被打包为 API 并在线部署，以便可以集成到您的工作流程中。

为什么选择 Apache SpamAssassin？

Apache SpamAssassin 是一个由 Apache 软件基金会维护的开源垃圾邮件检测平台。它使用多种规则、贝叶斯过滤和网络测试来为给定的电子邮件分配垃圾邮件“分数”。一般来说，得分为 5 或以上的电子邮件被标记为垃圾邮件的风险很高。

由于 SpamAssassin 的评分是透明且有据可查的，因此您还可以使用它来准确识别电子邮件的哪些方面导致了高垃圾邮件分数并提高您的写作水平。

SpamAssassin 入门

SpamAssassin 设计为在 Linux 系统上运行。您需要 Linux 操作系统或创建 Docker 虚拟机来安装和运行它。

在 Debian 或 Ubuntu 系统上，使用以下命令安装 SpamAssassin：

apt-get update && apt-get install -y spamassassin
sa-update

sa-update 命令确保 SpamAssassin 的规则是最新的。

安装后，您可以将电子邮件消息通过管道传输到 SpamAssassin 的命令行工具中。输出包括带有垃圾邮件分数的电子邮件的带注释版本，并解释了触发哪些规则。

典型用法可能如下所示：

spamassassin -t  results.txt

results.txt 将包含已处理的电子邮件以及 SpamAssassin 的标头和分数。

使用 FastAPI 将 SpamAssassin 包装为 API

接下来，让我们创建一个简单的 API，它接受两个电子邮件字段：主题和 html_body。它将把字段传递给 SpamAssassin 并返回验证结果。

FastAPI 代码示例

from fastapi import FastAPI
from datetime import datetime, timezone
from email.utils import format_datetime
from pydantic import BaseModel
import subprocess
import re

def extract_analysis_details(text):
    rules_section = re.search(r"Content analysis details:.*?(pts rule name.*?description.*?)\n\n", text, re.DOTALL)
    if not rules_section:
        return []

    rules_text = rules_section.group(1)
    pattern = r"^\s*([-\d.]+)\s+(\S+)\s+(.+)$"
    rules = []
    for line in rules_text.splitlines()[1:]:
        match = re.match(pattern, line)
        if match:
            score, rule, description = match.groups()
            rules.append({
                "rule": rule,
                "score": float(score),
                "description": description.strip()
            })
    return rules

app = FastAPI()

class Email(BaseModel):
    subject: str
    html_body: str

@app.post("/spam_check")
def spam_check(email: Email):
    # assemble the full email
    message = f"""From: example@example.com
To: recipient@example.com
Subject: {email.subject}
Date: {format_datetime(datetime.now(timezone.utc))}
Content-Type: text/html; charset="UTF-8"

{email.html_body}"""

    # Run SpamAssassin and capture the output directly
    output = subprocess.run(["spamassassin", "-t"], 
                            input=message.encode('utf-8'), 
                            capture_output=True)

    output_str = output.stdout.decode('utf-8', errors='replace')
    details = extract_analysis_details(output_str)
    return {"result": details}

回复将包含 SpamAssassin 结果的分析详细信息。

让我们以此输入为例：

subject:
Test Email

html_body:

  
    <p>This is an <b>HTML</b> test email.</p>
  

响应将是这样的：

[
  {
    "rule": "MISSING_MID",
    "score": 0.1,
    "description": "Missing Message-Id: header"
  },
  {
    "rule": "NO_RECEIVED",
    "score": -0.0,
    "description": "Informational: message has no Received headers"
  },
  {
    "rule": "NO_RELAYS",
    "score": -0.0,
    "description": "Informational: message was not relayed via SMTP"
  },
  {
    "rule": "HTML_MESSAGE",
    "score": 0.0,
    "description": "BODY: HTML included in message"
  },
  {
    "rule": "MIME_HTML_ONLY",
    "score": 0.1,
    "description": "BODY: Message only has text/html MIME parts"
  },
  {
    "rule": "MIME_HEADER_CTYPE_ONLY",
    "score": 0.1,
    "description": "'Content-Type' found without required MIME headers"
  }
]

在线部署API

运行SpamAssassin需要安装了该软件的Linux环境。传统上，您可能需要 EC2 实例或 DigitalOcean Droplet 进行部署，这可能成本高昂且乏味，特别是在您的使用量较低的情况下。

对于无服务器平台，它们通常不提供像 SpamAssassin 这样的直接方式来运行系统包。

现在使用 Leapcell，您可以部署像 SpamAssassin 这样的任何系统包，同时保持服务无服务器 - 您只需为调用付费，这通常更便宜。

在 Leapcell 上部署 API 非常简单。您不必担心如何设置 Linux 环境或如何构建 Dockerfile。只需选择要部署的Python镜像，并正确填写“Build Command”字段即可。

部署后，您将拥有一个可以按需调用的端点。每当您的 API 被调用时，它都会运行 SpamAssassin，对电子邮件进行评分，并返回响应。

以上是构建 API 让您的营销电子邮件远离垃圾邮件的详细内容。更多信息请关注PHP中文网其他相关文章！