Erstellen Sie eine API, um Ihre Marketing-E-Mails vor Spam zu schützen

Bei der Durchführung von E-Mail-Marketingkampagnen besteht eine der größten Herausforderungen darin, sicherzustellen, dass Ihre Nachrichten den Posteingang und nicht den Spam-Ordner erreichen.

Apache SpamAssassin ist ein weit verbreitetes Tool für viele E-Mail-Clients und E-Mail-Filtertools, um Nachrichten als Spam zu klassifizieren. In diesem Beitrag erfahren Sie, wie Sie SpamAssassin nutzen können, um zu überprüfen, ob Ihre E-Mail als Spam markiert wird und warum sie so markiert ist.
Die Logik wird als API gepackt und online bereitgestellt, sodass sie in Ihren Workflow integriert werden kann.

Warum Apache SpamAssassin?

Apache SpamAssassin ist eine Open-Source-Spam-Erkennungsplattform, die von der Apache Software Foundation verwaltet wird. Es verwendet eine Vielzahl von Regeln, Bayes'sche Filterung und Netzwerktests, um einer bestimmten E-Mail einen Spam-„Score“ zuzuweisen. Im Allgemeinen besteht bei einer E-Mail mit einem Wert von 5 oder höher ein hohes Risiko, als Spam gekennzeichnet zu werden.

Da die Bewertung von SpamAssassin transparent und gut dokumentiert ist, können Sie damit auch genau identifizieren, welche Aspekte Ihrer E-Mail hohe Spam-Bewertungen verursachen, und Ihr Schreiben verbessern.

Erste Schritte mit SpamAssassin

SpamAssassin ist für die Ausführung auf Linux-Systemen konzipiert. Sie benötigen ein Linux-Betriebssystem oder erstellen eine Docker-VM, um es zu installieren und auszuführen.

Auf Debian- oder Ubuntu-Systemen installieren Sie SpamAssassin mit:

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

Der Befehl sa-update stellt sicher, dass die Regeln von SpamAssassin auf dem neuesten Stand sind.

Nach der Installation können Sie eine E-Mail-Nachricht an das Befehlszeilentool von SpamAssassin weiterleiten. Die Ausgabe enthält eine kommentierte Version der E-Mail mit Spam-Scores und erklärt, welche Regeln ausgelöst werden.

Eine typische Verwendung könnte so aussehen:

spamassassin -t  results.txt

results.txt enthält dann die verarbeitete E-Mail mit den Headern und Bewertungen von SpamAssassin.

Verwenden Sie FastAPI, um SpamAssassin als API einzubinden

Als nächstes erstellen wir eine einfache API, die zwei E-Mail-Felder akzeptiert: Betreff und html_body. Die Felder werden an SpamAssassin übergeben und das Validierungsergebnis zurückgegeben.

Beispiel-FastAPI-Code

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}

Die Antwort enthält die Analysedetails der SpamAssassin-Ergebnisse.

Nehmen wir diese Eingabe als Beispiel:

subject:
Test Email

html_body:

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

Die Antwort wäre so:

[
  {
    "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"
  }
]

Bereitstellen der API online

Für die Ausführung von SpamAssassin ist eine Linux-Umgebung mit installierter Software erforderlich. Normalerweise benötigen Sie für die Bereitstellung möglicherweise eine EC2-Instanz oder ein DigitalOcean-Droplet, was kostspielig und mühsam sein kann, insbesondere wenn Ihr Nutzungsvolumen gering ist.

Serverlose Plattformen bieten oft keine einfache Möglichkeit, Systempakete wie SpamAssassin auszuführen.

Jetzt können Sie mit Leapcell beliebige Systempakete wie SpamAssassin bereitstellen, während der Dienst serverlos bleibt – Sie zahlen nur für Aufrufe, was normalerweise günstiger ist.

Die Bereitstellung der API auf Leapcell ist sehr einfach. Sie müssen sich keine Gedanken darüber machen, wie Sie eine Linux-Umgebung einrichten oder eine Docker-Datei erstellen. Wählen Sie einfach das Python-Image für die Bereitstellung aus und füllen Sie das Feld „Build Command“ ordnungsgemäß aus.

Nach der Bereitstellung verfügen Sie über einen Endpunkt, den Sie bei Bedarf anrufen können. Immer wenn Ihre API aufgerufen wird, führt sie SpamAssassin aus, bewertet die E-Mail und gibt die Antwort zurück.

Das obige ist der detaillierte Inhalt vonErstellen Sie eine API, um Ihre Marketing-E-Mails vor Spam zu schützen. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!