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

Import von Briefen als E-Mails über IMAP

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:

  1. Verbinden des Postfachs wie hier beschrieben: E-Mails verbinden

  2. 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.

Import von Briefen über die REST API

  1. Beim Import von Briefen über die API muss das channel-Attribut auf „letter“ gesetzt werden. Enneo übernimmt den Rest.

  2. 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 entweder auf batch (Standard) oder realtime gesetzt werden. Bei realtime wird der Brief sofort und nicht asynchron durch die KI verarbeitet, was die Anfrage etwas länger dauern lassen kann.

  • 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