Hinweis
Mit eigenen Widgets holen Sie Ihre anderen Systeme direkt in MEMOIO: als Menüeintrag an einer Nachricht oder einem Kontakt, als Kachel auf der Startseite, als Vorschlag im Eingabefeld oder als Verweis auf einen Datensatz, etwa einen Auftrag oder ein Ticket.
Im Kern ist jedes Widget ein Link: Sie hinterlegen eine Adresse (URL), und klickt ein Nutzer darauf, so öffnet MEMOIO diese Adresse. In die URL bauen Sie Platzhalter ein, die MEMOIO mit Daten aus dem jeweiligen Zusammenhang füllt. So landet der Nutzer in Ihrem System direkt beim passenden Datensatz. Welche Platzhalter zur Verfügung stehen, hängt vom Typ des Widgets ab: Ein Client-Link kennt etwa ${conversation} für die ID der Unterhaltung oder ${email} für die E-Mail-Adresse eines Kontakts, ein Referenz-Anbieter nur ${reference}. Ob sich die Adresse in MEMOIO oder in einem neuen Fenster öffnet, bestimmt ein Präfix vor der URL.
Eigene Widgets verwalten Sie in den Einstellungen unter „Eigene Widgets“. Dafür benötigen Sie das Recht „Unternehmen verwalten“. Über „Neu Erstellen“ wählen Sie zunächst den Typ:
| Client-Link | ein zusätzlicher Eintrag im Menü einer Nachricht oder eines Kontakts |
| Startseiten-Element | eine Kachel mit Links auf der Startseite |
| Chat-Eingabefeld | ein Vorschlag, den Nutzer im Eingabefeld einer Unterhaltung auswählen |
| Referenz-Anbieter | macht Referenzen wie auftrag:4711 lesbar und anklickbar |
Allen Typen gemeinsam sind diese Felder:
- Bezeichner: der angezeigte Name des Widgets.
- Sortierung: bestimmt die Reihenfolge; Widgets mit kleinerer Zahl stehen weiter vorne. Eigene Widgets reihen sich dabei zwischen die eingebauten ein.
- Benötigte Gruppe: Ist eine Nutzergruppe eingetragen, so sehen das Widget nur deren Mitglieder.
Änderungen an Widgets erreichen Ihre Mitarbeiter spätestens nach einer Stunde.
Ein Client-Link ergänzt das Menü einer Nachricht oder eines Kontakts um einen eigenen Eintrag. Wo er erscheint, legt der Untertyp fest, den Sie beim Anlegen wählen:
| Nachricht | an jeder Nachricht |
| Eigene Nachricht / Externe Nachricht | nur an Nachrichten, die der Nutzer selbst bzw. jemand anderes geschrieben hat |
| Kürzlich gesendete … | nur an Nachrichten, die sich noch aufspalten lassen, wahlweise an allen, eigenen oder fremden |
| Unmittelbar gesendete … | nur an Nachrichten, die gerade erst gesendet wurden, also solange eigene Nachrichten noch bearbeitet werden können |
| Person | an jedem Kontakt |
| Person mit Firma | an Kontakten, die einem Unternehmen angehören |
| Mitarbeiter / Externe Person | nur an Kontakten aus dem eigenen Unternehmen bzw. an allen übrigen Kontakten, auch solchen ohne Unternehmen |
In der URL setzt MEMOIO beim Aufruf folgende Platzhalter ein:
| an Nachrichten | ${conversation} (ID der Unterhaltung), ${topic} (Betreff), ${message} (ID der Nachricht), ${text} (Text der Nachricht), ${timestamp} (Datum und Uhrzeit, wie angezeigt), ${sender} (ID des Absenders), ${senderName}, ${senderEmail} |
| an Kontakten | ${account} (ID des Kontos), ${partnerName}, ${email}, ${phone}, ${mobile}, ${position}, ${company} (ID des Unternehmens), ${companyName}, ${partnerToken} |
| überall | ${host} (die Adresse von MEMOIO, also https://memoio.test.scireum.com) |
Die eingesetzten Werte werden für die URL passend kodiert. Verwenden Sie jeden Platzhalter höchstens einmal je URL; MEMOIO ersetzt nur das erste Vorkommen. Fehlt ein Wert, etwa weil ein Kontakt keine Telefonnummer hinterlegt hat, so steht an seiner Stelle null.
Unter „URL zu kleinem Icon“ hinterlegen Sie ein Symbol, das im Menü neben dem Bezeichner erscheint.
Ein Startseiten-Element ist eine Kachel auf der Startseite mit Überschrift, Beschreibung und einer Liste von Links. Jeder Link hat einen eigenen Bezeichner, eine eigene URL und auf Wunsch eine eigene benötigte Gruppe. Die Kachel selbst ist nicht anklickbar, nur ihre Links. Als Platzhalter steht in deren URLs nur ${host} zur Verfügung.
Als Symbol hinterlegen Sie zwei Grafiken: das kleine Icon für die mobile Ansicht, das große für die Ansicht am Computer.
Tippt ein Nutzer im Eingabefeld einer Unterhaltung ein ! oder klickt auf das Blitz-Symbol, so öffnet sich eine Liste mit Widgets. Ein Widget vom Typ Chat-Eingabefeld erscheint dort auf zwei Arten:
- Einfacher Vorschlag: ein fester Eintrag aus Bezeichner, Beschreibung und URL. Er wird angezeigt, wenn das Eingetippte zu Bezeichner oder Beschreibung passt. Als Platzhalter steht in der URL nur ${host} zur Verfügung.
- API-Anbindung: MEMOIO fragt Ihren Server beim Öffnen der Liste und bei jeder weiteren Eingabe erneut, welche Vorschläge er anbieten möchte. Ist eine API-URL eingetragen, so ignoriert MEMOIO die Felder des einfachen Vorschlags. Wie Ihr Server antworten muss, beschreibt Schnittstelle für eigene Widgets.
Mit dem Befehl /referenzieren (englisch /ref) verknüpfen Nutzer eine Unterhaltung mit einem Datensatz, etwa auftrag:4711. Der Teil vor dem Doppelpunkt ist der Code des Referenz-Anbieters, der Teil danach der Wert. Der Referenz-Anbieter mit diesem Code bestimmt, wie die Referenz in den Details der Unterhaltung erscheint und wohin sie führt.
Für die Darstellung gibt es zwei Wege:
- Feste Text-Referenz: Unter „Beschreibung“ tragen Sie den angezeigten Text ein, unter „URL“ die Adresse, die sich beim Klick auf den Pfeil neben der Referenz in einem neuen Fenster öffnet. In beiden Feldern steht ${reference} für den Wert der Referenz, etwa https://erp.example.com/auftrag/${reference}. Andere Platzhalter sind hier nicht möglich; geben Sie die URL daher vollständig an. Enthält eines der Felder einen anderen Platzhalter, so lässt sich die Referenz nicht mehr anzeigen.
- API-Anbindung: MEMOIO fragt für jede Referenz Ihren Server nach Text und Adresse. Auf Wunsch liefert dieser auch Vorschläge, während ein Nutzer /referenzieren eintippt. Ist eine API-URL eingetragen, so ignoriert MEMOIO die Felder der festen Text-Referenz. Details beschreibt Schnittstelle für eigene Widgets.
Ist eine „Archivgruppe für Unterhaltungen“ eingetragen, so ordnet MEMOIO Unterhaltungen mit einer solchen Referenz dieser Archivgruppe zu, sofern sie noch keiner zugeordnet sind und ihre Referenzen nicht auf verschiedene Archivgruppen verweisen.
Was beim Klick auf ein Widget geschieht, bestimmt ein Präfix vor der eigentlichen Adresse. Dies gilt für Client-Links, Startseiten-Elemente und Chat-Eingabefelder:
| dialog: | öffnet die Adresse in einem Dialogfenster mit Titelzeile über MEMOIO |
| page: | wie dialog:, aber ohne Titelzeile und fast über die ganze Fläche von MEMOIO |
| http: | öffnet die Adresse in einem neuen Fenster |
| search: | startet eine Suche mit dem angegebenen Suchtext |
| start: | beginnt eine neue Unterhaltung, etwa start:email:max@example.com |
Auf das Präfix folgt die vollständige Adresse, zum Beispiel dialog:https://erp.example.com/kunde/${companyName} oder http:https://erp.example.com/kunde/${companyName}.
Bei dialog: und page: zeigt MEMOIO Ihre Seite in einem eingebetteten Rahmen (iframe) an, also innerhalb der MEMOIO-Oberfläche statt in einem eigenen Fenster. In den mobilen Apps öffnet sich die Seite stattdessen in einer eigenen Ansicht der App; die folgenden Einschränkungen betreffen daher nur den Browser und die Desktop-Anwendung.
- Ihr Server muss erlauben, dass MEMOIO seine Seiten einbettet. Viele Anwendungen verbieten das standardmäßig, und der Dialog bleibt dann leer. Erlauben lässt es sich nur über den HTTP-Header Content-Security-Policy mit der Direktive frame-ancestors https://memoio.test.scireum.com. Einen Header X-Frame-Options muss Ihr Server dann weglassen, denn dieser kennt keine Ausnahme für MEMOIO.
- Ihre Seite muss per https:// erreichbar sein; Browser laden in MEMOIO keine unverschlüsselten Seiten.
- Meldet sich der Nutzer auf Ihrer Seite an, so muss Ihr Server das Sitzungs-Cookie mit SameSite=None; Secure setzen. Manche Browser blockieren solche Cookies eingebetteter Seiten trotzdem; der Nutzer wird dann bei jedem Aufruf erneut nach seiner Anmeldung gefragt.
Lässt sich das nicht einrichten, so öffnen Sie die Seite mit http: in einem neuen Fenster.