Kundenlink
Für KI-Agenten: maschinenlesbare Version unter https://app.miovea.com/wiki/vorgaenge/kundenlink.md
Über einen Kundenlink arbeitet der Endkunde selbst mit: Unterlagen hochladen, Fragebogen ausfüllen. Der Link führt auf eine Seite unter /p/<token> und braucht keinen Account.
Prinzip
Der Makler stellt den Link zusammen und schickt ihn dem Kunden. Der Kunde öffnet ihn, gibt das vereinbarte Kennwort ein und sieht nur die Blöcke, die der Makler für ihn freigegeben hat. Der Link ist kein Login: Wer ihn hat, kommt bis zur Kennwortabfrage.
Ein verbundener Agent kann Kundenlinks verwalten, aber nicht versenden: public_pages.list zeigt die Links eines Kunden oder Vorgangs, questionnaires.link.create veröffentlicht den Fragebogenlink eines Vorgangs, questionnaires.link.close schließt ihn oder öffnet ihn wieder. Freie Links und den Votenvergleich beschreibt der Guide preinquiries (read_guide). Link und Passwort gibt der Makler an den Kunden weiter. Beides ist sensibel: nur an den Kunden selbst, nie in Notizen oder E-Mails an Dritte.
Was der Kunde auf seiner Seite tut, läuft über einen eigenen Kundenkanal, den weder Agenten noch API-Keys aufrufen können. Relevant ist es für dich, weil die Antworten und Uploads des Kunden im selben Datenstand landen, auf dem du arbeitest.
Zwecke
Jeder Link hat einen Zweck, der festlegt, was er kann:
| Zweck | Anzeige | Kunde kann | Ablauf |
|---|---|---|---|
questionnaire | Fragebogen | antworten und hochladen | ohne Frist |
document_request | Unterlagenanforderung | hochladen | ohne Frist |
vote_sharing | Votenvergleich | nur lesen | Frist nötig, Standard 30 Tage |
general | Kundenlink | antworten und hochladen | ohne Frist |
Live-Fragebogen
Steht ein Fragebogen auf dem Link, tippt der Kunde direkt im gemeinsamen Stand. Was er speichert, siehst du sofort über questionnaires.get, und was du schreibst, erscheint sofort bei ihm.
Daraus folgt: Bevor du bestehende Antworten änderst, lies den Stand neu. questionnaires.get nennt je Antwort last_edited_by (customer oder advisor) und updated_at. Steht dort customer, frag beim Nutzer nach, bevor du die Antwort mit questionnaires.answers.set überschreibst.
Details zum Ausfüllen in .