Marktplatz und Postfach an den Verkaufsagenten anschliessen

Ein Händler beantwortet Anfragen an drei Stellen: im Marktplatz-Postfach, im eigenen Mailprogramm und auf der Website. Drei Oberflächen bedeuten drei Antwortqualitäten, drei Bearbeitungszeiten und die regelmäßige Situation, dass zwei Kollegen dieselbe Anfrage unterschiedlich beantworten.

Ein Kanal ist die Verbindung zu genau einer Quelle und trägt sein eigenes Profil und seine eigenen Zugangsdaten. Entscheidend ist die Trennung: Zugangsdaten lassen sich widerrufen, ohne den Kanal zu löschen — der Verlauf bleibt, der Zugriff endet.

Was dieser Fall voraussetzt

• Ein Profil je Kanal. Marktplatz und Postfach dürfen unterschiedlich antworten; das Profil entscheidet über Ton und Befugnisse.
• Ein eigenes Postfach für den Agenten. Ein gemeinsam genutztes Postfach führt dazu, dass Agent und Mensch sich gegenseitig Nachrichten wegnehmen.
• Ein Konto beim Marktplatz, dessen Inhaber einwilligen kann. Die Einwilligung erteilt der Kontoinhaber selbst, nicht wir — sie lässt sich nicht ersetzen.
• Eine Überwachung des Kanalzustands. Ein Kanal, dessen Postfach seit drei Tagen abweist, fällt nur auf, wenn jemand hinsieht.

Der Ablauf

Die Tabelle nennt je Stufe den zuständigen Aufruf und das, was danach vorliegt. Die Begründung, warum die Stufe nicht übersprungen werden kann, steht darunter.

Warum jede Stufe nötig ist

1. Den Kanal anlegen. POST /agent/channels verlangt type, name und profileId und nimmt settings. Für ein Postfach gehören imap und smtp dazu — Host, Port und Benutzername, aber kein Passwort. Das ist Absicht: Geheimnisse gehen einen eigenen Weg.
2. Die Einwilligung des Marktplatzes einholen. POST /agent/channels/{channelId}/ebay/consent gibt eine authorizeUrl zurück. Der Kontoinhaber erteilt die Einwilligung dort, und die Rückkehr läuft über den vorgesehenen Rückkehrpfad. Zugangsdaten des Marktplatzes werden nie eingetippt.
3. Die Postfachgeheimnisse hinterlegen. PUT /agent/channels/{channelId}/mail/credentials nimmt die Passwörter entgegen und antwortet mit imapStored und smtpStored. Es kommt kein Passwort zurück: Laut Vertrag gehen Passwörter unmittelbar in den verschlüsselten Speicher, werden nie protokolliert und sind nie Teil der Kanaleinstellungen.
4. Das Postfach prüfen. POST /agent/channels/{channelId}/mail/test meldet sich zum Lesen an, wählt den Ordner und geht zum Senden bis zur Anmeldung; versendet wird nichts. Diese Stufe gehört vor den Betrieb, nicht danach: Ein falsches Passwort fällt sonst erst auf, wenn ein Kunde auf eine Antwort wartet.
5. Den Zustand beobachten. GET /agent/channels/{channelId}/status liefert nextPollAt, errorCount, lastErrorCode, pendingEvents und pendingOutbound. Das ist die Stelle, an der eine Überwachung ansetzt — auf Zahlen, nicht auf Vermutungen.

curl -X POST \
  -H 'X-Api-Key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"returnUrl":"https://example.de/agent/einwilligung-fertig"}' \
  'https://api.tapinomahub.com/hub/index.php/agent/channels/<channelId>/ebay/consent'

Was am Ende vorliegt

Am Ende antworten Marktplatz, Postfach und Website in derselben Qualität, und jeder Kanal lässt sich einzeln anhalten, prüfen oder widerrufen, ohne die übrigen zu berühren.

Wo das in der Dokumentation steht

Die verbindlichen Feldlisten, Fehlercodes und Beispielantworten stehen im OpenAPI-Vertrag dieser Fläche unter docs.tapinomahub.com (tapinoma-agent). Alle Anwendungsfälle nach Fläche und Rolle geordnet: Übersicht der Anwendungsfälle.