Vorbereitung für SuperOffice Meeting: API E-Mail-Versand (Shipment)

Datum: 05.03.2026
Teilnehmer: Christian Godelmann (RoboPlanet), Frau Grilnberger / Herr Eberhard (SuperOffice)
Thema: Fehlende Berechtigung für automatisierten E-Mail-Versand via API

1. Ausgangslage & Ziel

Wir haben die GTM-Engine (KI-basierte Anreicherung) erfolgreich an SuperOffice (Tenant Cust26720) angebunden.

✅ Lese-Zugriff: Funktioniert (Webhooks, Person/Contact lesen).
✅ Schreib-Zugriff (Daten): Funktioniert (UDFs schreiben, Sales erstellen).
❌ E-Mail-Versand (Shipment): Schlägt fehl (500 Internal Server Error).

Ziel: Der API-User (Client ID 0fd8...) soll automatisierte Erstkontakt-E-Mails ("Shipments") im Namen des zugewiesenen Vertriebsmitarbeiters versenden können.

2. Diagnose-Ergebnisse (Live-Test vom 05.03.2026)

Wir haben eine Tiefenanalyse mit Admin-Rechten durchgeführt. Hier sind die harten Fakten:

A. Identitätsproblem (Ursache)

Der API-User hat keine verknüpfte "Person" im System.

Request: GET /api/v1/Associate/Me
Response: 500 Internal Server Error
Bedeutung: Das System weiß nicht, "wer" der API-User ist. Ohne Identität können keine personalisierten Aktionen (wie E-Mail-Versand) ausgeführt werden.

B. E-Mail-Versand (Blockade)

Trotz aktiver Marketing-Lizenz (ShipmentTypes sind abrufbar) scheitert der Versand.

Test: Erstellung eines Shipment Objekts (Type: Email).
Response: 500 Internal Server Error

Log-Auszug:

{
  "Error": true,
  "ErrorType": "NullReferenceException",
  "Message": "Object reference not set to an instance of an object.",
  "Source": "SoDataBase"
}

(Hinweis: Der Fehler deutet darauf hin, dass interne E-Mail-Einstellungen (SMTP/Exchange) für den user null sind.)

C. Schreibrechte (Erfolgreich)

Zum Vergleich haben wir andere Objekte erstellt, um generelle API-Probleme auszuschließen.

Sale (Verkauf): ✅ Erfolgreich erstellt (ID 342539).
Appointment (Termin): ✅ Erfolgreich erstellt (ID 993350).

3. Unsere Bitte an SuperOffice (Lösungsvorschlag)

Um das Problem zu lösen, benötigen wir folgende Anpassungen für den API-User (oder einen dedizierten System-User):

Personalisierung: Verknüpfung des API-Users mit einer Personalkarte im SuperOffice (damit Associate/Me funktioniert).
Rollen: Zuweisung der Rolle "Mailing Administrator" (oder vergleichbar), um Shipments zu erstellen.
E-Mail-Konfiguration: Hinterlegung der E-Mail-Einstellungen (idealerweise "Send As" Recht für die Account-Manager, damit die Mails im Namen von Herrn Godelmann/Herrn X rausgehen).

4. Aktueller Workaround (Plan B)

Bis zur Lösung nutzen wir folgenden Workaround:

Die KI generiert den E-Mail-Text.
Anstatt die Mail zu senden, erstellen wir einen Termin (Appointment) in der Vergangenheit.
Der E-Mail-Text wird in die Beschreibung des Termins geschrieben.
Der Vertriebler muss den Text manuell kopieren und versenden.

Dies ist funktionstüchtig (getestet), aber keine Dauerlösung.

5. Technische Details (für Support)

Tenant: Cust26720 (Online3)
Client ID: 0fd8... (Name: "Gemini Connector Production")
Authentication: System User Flow (Refresh Token)
Endpoint: /api/v1/Shipment

Ende des Protokolls

3.4 KiB Raw Blame History