Mit der MeisterTask-Integration legt smao nach einem Anruf automatisch eine Aufgabe in einem Abschnitt eines MeisterTask-Projekts an. Die Integration verwendet einen persönlichen Zugriffstoken deines Meister-Kontos. Es öffnet sich deshalb kein Anmeldefenster im Browser.
Persönlichen Zugriffstoken erstellen
Melde dich mit dem Meister-Konto an, das smao verwenden soll. Am besten ist das ein eigener Benutzer, der Mitglied jedes Projekts ist, in dem Aufgaben angelegt werden sollen. Erstelle unter Einstellungen → Integrationen → Verbundene Apps oder auf der API-Seite des Kontos einen persönlichen Zugriffstoken mit den Bereichen userinfo.profile, userinfo.email und meistertask. Eine eigene Anwendung musst du dafür nicht registrieren.
Der Zugriffstoken wird nach dem Speichern in smao nicht mehr angezeigt. Gib ihn nur erneut ein, wenn du ihn ändern möchtest.
| Feld | Bedeutung |
|---|---|
| Persönlicher Zugriffstoken | Der in Schritt 1 erstellte Token. Eine Adresse ist nicht nötig; MeisterTask hat einen festen Endpunkt. |
MeisterTask verbinden
Öffne im Dashboard die Integrationen, wähle MeisterTask und trage den Zugriffstoken ein. Beim Verbinden prüft smao den Token mit einer einzigen Abfrage deines Meister-Profils. Erst danach wird die Verbindung verschlüsselt gespeichert. Die Projektmitgliedschaft wird dabei noch nicht geprüft; sie zeigt sich beim Laden des Nodes und beim Anlegen der ersten Aufgabe.
Lehnt MeisterTask den Token ab, meldet smao Die Authentifizierung mit der Integration ist fehlgeschlagen. Beim erneuten Verbinden zeigt das Formular nur an, dass ein Token gespeichert ist. Lässt du das Feld leer, bleibt der gespeicherte Token erhalten.
Aufgaben-Node zur Anrufanalyse hinzufügen
Öffne deine Anrufanalyse und füge die MeisterTask-Aktion Aufgabe anlegen hinzu. Wähle zuerst das Projekt und danach den Abschnitt, in dem die Aufgabe erscheinen soll; beide Listen werden beim Öffnen des Nodes live aus MeisterTask geladen. Der Titel ist ein Pflichtfeld. In Titel und Notizen kannst du mit @ eine vorhandene Analysevariable einsetzen.
| Einstellung | Verhalten |
|---|---|
| Projekt | Pflichtfeld; angeboten werden nur aktive Projekte mit mindestens einem aktiven Abschnitt |
| Abschnitt | Pflichtfeld; die Abschnitte (Spalten) des gewählten Projekts in Board-Reihenfolge |
| Titel | Pflichtfeld; der Titel der Aufgabe, z. B. eine @Variable mit generiertem Titel |
| Notizen | Optional; die Beschreibung der Aufgabe, z. B. die Zusammenfassung des Anrufs. Zeilenumbrüche bleiben erhalten; Markdown-Zeichen werden maskiert, damit sie als Text erscheinen. |
| Zugewiesen an | Optional; Liste der Personen, die der Token sieht. Die Person muss Mitglied des gewählten Projekts sein, sonst lehnt MeisterTask die Aufgabe ab. |
| Aufgaben-ID, Aufgaben-Token, Aufgaben-URL | Optionale Variablennamen für die Werte, die MeisterTask nach dem Anlegen zurückgibt |
MeisterTask kennt keine Kontakte. Der Anrufer wird deshalb nicht verknüpft; setze seine Daten als @Variablen in die Notizen, z. B. Name, Telefonnummer und E-Mail-Adresse. Die Variablen, die mit caller beginnen, enthalten die Anruferdaten; für die Telefonnummer empfiehlt sich die Variable phoneNumber, die genau die Nummer enthält, mit der angerufen wurde.
Aufgabendaten weiterverwenden
Wenn du Variablennamen für Aufgaben-ID, Aufgaben-Token und Aufgaben-URL angibst, stehen die Werte in nachfolgenden Nodes zur Verfügung. Die Aufgaben-URL ist der Link zur Aufgabe in MeisterTask und wird aus dem Aufgaben-Token gebildet.
Bei einem ungültigen oder widerrufenen Token fordert das Dashboard eine erneute Verbindung an; die gespeicherte Konfiguration bleibt dabei erhalten. Findet smao kein aktives Projekt mit einem aktiven Abschnitt, schlägt das Laden des Nodes mit einem Hinweis auf die Projektmitgliedschaft fehl; Projekte ohne Abschnitte werden übersprungen und in der Zeitleiste vermerkt. MeisterTask erlaubt 120 Anfragen pro Minute und sperrt den Zugriff danach für drei Minuten; smao meldet dann zu viele Anfragen und legt die Aufgabe nicht erneut an. Wenn ein Lauf nach einer möglicherweise erfolgreichen Erstellung unterbrochen wurde, wird der Node nicht automatisch erneut ausgeführt. Prüfe in MeisterTask, ob die Aufgabe bereits vorhanden ist, bevor du manuell einen neuen Analyselauf startest.
In Version 1 nicht unterstützt: Fälligkeitsdatum, Labels, Checklisten, Kommentare, benutzerdefinierte Felder, Anhänge, ein anderer Status als offen, das Aktualisieren von Aufgaben, Kontaktimport und mehrere MeisterTask-Verbindungen je Organisation.