Brief

Genau wie E-Mails können auch Briefe in Enneo auf zwei Arten verbunden werden, abhängig von den Anforderungen: IMAP und API.

Empfang von Briefen

Variante 1: Import von Briefen als E-Mail mit Anhang

Diese Lösung wird empfohlen, wenn ein Scandienst verwendet wird, der eingehende Briefe in E-Mails mit den Briefen als Anhang (z. B. PDF) umwandelt.

Zum Verbinden von Briefen sind folgende Schritte notwendig:

Verbinden des Postfachs wie hier beschrieben: E-Mails verbinden
Sicherstellen, dass die E-Mails als Briefe erkannt werden. Enneo erkennt eine E-Mail als Brief, wenn folgende Kriterien erfüllt sind:
- Der Absender der E-Mail ist der Scandienst. Die E-Mail-Adresse des Absenders kann in den Brief-Einstellungen angegeben werden.
- Der Betreff der E-Mail enthält ausschließlich das Wort „LETTER“. Falls ein anderes Schlüsselwort bevorzugt wird, kann dies in den Brief-Einstellungen angepasst werden.

Variante 2: Import von Briefen über die REST API

Beim Import von Briefen über die API muss das channel-Attribut auf „letter“ gesetzt werden. Enneo übernimmt den Rest.
Ein Beispiel für eine Anfrage mit minimalen Parametern:

curl --location 'https://demo.enneo.ai/api/mind/ticket' \
--header 'Authorization: bearer <token>' \
--data '{
    "channel": "letter",
    "process": "batch",
    "attachments": [
        {
            "base64": "base-64-encoded-string-of-pdf-or-image-file",
        }
    ]
}

Hinweise:

Der Parameter process kann auf batch (Standard), realtime oder false gesetzt werden. In allen Fällen kehrt die API-Antwort sofort nach dem Speichern des Tickets zurück – die KI-Verarbeitung läuft im Hintergrund. Der Unterschied liegt darin, wann sie startet: Bei batch wird das Ticket in die normale Verarbeitungswarteschlange eingereiht und vom nächsten freien Worker abgearbeitet. Bei realtime wird die KI-Verarbeitung sofort in einem eigenen Hintergrundprozess angestoßen, ohne in der Warteschlange zu warten – sinnvoll, wenn ein Ticket bevorzugt sofort verarbeitet werden soll. Bei false wird das Ticket ohne KI-Verarbeitung angelegt.
Anhänge können entweder als Base64-kodierte Dateien über den Parameter base64 hochgeladen oder über eine URL mit dem Parameter url bereitgestellt werden.
Alle Ticket-Attribute, die in der API-Spezifikation definiert sind, können ebenfalls angegeben werden. Dies ist nützlich, um Metadaten wie eine Vertrags-ID, Tags oder ein Erstellungsdatum zu übermitteln.

Unterstützte Dateiformate

Enneo unterstützt die automatische Konvertierung von Anhängen in folgenden Formaten:

PDF
PNG
JPG
TIFF

Enneo übergibt wenn ein Brief versendet werden soll ein JSON-Objekt mit den relevanten Daten wie Empfänger, Betreff und Textinhalt an ihren Usercode. Von dort können sie per API einen Druckdienstleister ihrer Wahl aufrufen.

Dies konfiguriert man unter Einstellungen -> Briefe -> (Postfach auswählen) -> Webhooks -> Brief versenden

Hier ist Beispielcode für den Briefversand:

import importlib.util
import os
import json

file_path = os.getenv("SDK", "sdk.py")
spec = importlib.util.spec_from_file_location("sdk", file_path)
sdk = importlib.util.module_from_spec(spec)
spec.loader.exec_module(sdk)

input_data = sdk.load_input_data()
ticket_id = input_data.get("ticketId")

# Optional: load ticket data if you need it elsewhere
ticket_data = sdk.ApiEnneo.get(f"/api/mind/ticket/{ticket_id}")

# Build payload from input_data
payload = {
    "to": input_data.get("to"),
    "subject": input_data.get("subject"),
    "body": input_data.get("body"),
    "attachments": input_data.get("attachments", []),
    "userId": input_data.get("userId"),
    "ticketId": ticket_id,
    "conversationId": input_data.get("conversationId", ""),
    "contractId": input_data.get("contractId"),
    "customerId": input_data.get("customerId"),
    "subchannelId": input_data.get("subchannelId", ""),
}

try:
    echo_response = sdk.Api.call(
        method="POST",
        url="https://echo.enneo.ai/api/echo", # replace with your printing service here
        headers={},
        params=payload,
    )
    output_msg = "Letter sent successfully"
except Exception as e:
    print(json.dumps({"input": input_data, "error": str(e)}))
    exit(1)

print(json.dumps({
    "input": input_data,
    "payloadSentToEcho": payload,
    "echoResponse": echo_response,
    "output": output_msg,
}))

Validierung von Postanschriften

Enneo validiert Postanschriften, damit keine Briefe an ungültige Anschriften versandt werden und als Postrückläufer zurück geschickt werden. Diese sind hier beschrieben: Adressvalidierung

Nutzung von in ERP hinterlegten Adressen