Mit der weclapp-Integration legt smao nach einem Anruf automatisch ein Ticket in weclapp an. Die Integration verwendet den API-Token eines weclapp-Benutzers. Es öffnet sich deshalb kein Anmeldefenster im Browser.
API-Token in weclapp erstellen
Verwende für smao einen eigenen weclapp-Benutzer mit dem Ticketmodul und Leserechten auf Kunden und Kontakte. Öffne in weclapp Meine Einstellungen → API und erstelle den API-Token. Der Token ist an diesen Benutzer gebunden: Ein neuer Token macht den alten ungültig, und er läuft nicht von selbst ab.
Der API-Token wird nach dem Speichern in smao nicht mehr angezeigt. Gib ihn nur erneut ein, wenn du ihn ändern möchtest.
| Feld | Bedeutung |
|---|---|
| weclapp-URL | Die Adresse deiner weclapp-Umgebung, wie im Browser angezeigt, z. B. https://firma.weclapp.com. Nur die Adresse ohne Pfad; smao ergänzt den API-Pfad selbst. |
| API-Token | Der in Schritt 1 erstellte Token des Servicebenutzers. |
weclapp verbinden
Öffne im Dashboard die Integrationen, wähle weclapp und trage weclapp-URL und API-Token ein. Beim Verbinden prüft smao Adresse und Token mit einer einzigen Abfrage des aktuellen Benutzers. Erst danach wird die Verbindung verschlüsselt gespeichert. Ob der Benutzer das Ticketmodul und die nötigen Rechte hat, zeigt sich erst beim Laden des Nodes oder beim Anlegen des ersten Tickets.
Lehnt weclapp den Token ab, meldet smao Die Authentifizierung mit der Integration ist fehlgeschlagen. Beim erneuten Verbinden bleibt die weclapp-URL vorausgefüllt; ein unveränderter API-Token muss nicht erneut eingegeben werden.
Ticket-Node zur Anrufanalyse hinzufügen
Öffne deine Anrufanalyse und füge die weclapp-Aktion Ticket anlegen hinzu. Betreff, Beschreibung und Status sind Pflichtfelder. Status, Priorität, Kategorie, Kanal, Tickettyp und die Benutzerliste werden beim Öffnen des Nodes live aus weclapp geladen; deaktivierte Einträge erscheinen nicht. Als Status ist der Eintrag vorausgewählt, den weclapp für intern angelegte Tickets vorsieht. In den Textfeldern kannst du mit @ eine vorhandene Analysevariable einsetzen.
| Einstellung | Verhalten |
|---|---|
| Betreff | Pflichtfeld; der Titel des Tickets, z. B. eine @Variable mit generiertem Titel |
| Beschreibung | Pflichtfeld; der Tickettext, wie ihn die Bearbeiter lesen, z. B. die Zusammenfassung des Anrufs. Zeilenumbrüche bleiben erhalten. |
| Status | Pflichtfeld; Liste der Ticketstatus aus weclapp |
| Priorität, Kategorie, Kanal, Tickettyp | Optionale Listen aus weclapp; beim Kanal bietet sich ein Eintrag wie Telefon an |
| Zugewiesener Benutzer | Optional; ohne Angabe bleibt das Ticket den Zuweisungsregeln in weclapp überlassen |
| Anrufer (Vorname, Nachname, E-Mail, Telefon) | Optional; E-Mail und Telefon dienen zum Finden des Kunden oder Kontakts, alle vier Angaben werden für einen unbekannten Anrufer als Text übernommen |
| Ticket-ID, Ticketnummer | Optionale Variablennamen für die Werte, die weclapp nach dem Anlegen zurückgibt |
smao sucht den Anrufer in weclapp zuerst über die E-Mail-Adresse, danach über die Telefonnummer (Telefon und Mobil 1). Wird genau ein Kunde oder Kontakt gefunden, hängt das Ticket an ihm und bei einem Kontakt auch an dessen Kunden; der Datensatz wird nie verändert. Bei mehreren Treffern oder ohne Treffer werden Vorname, Nachname, E-Mail und Telefon als Text auf dem Ticket hinterlegt, so wie weclapp einen unbekannten Anrufer erfasst. Ein unbekannter Anrufer lässt den Node nie fehlschlagen.
Ticketdaten weiterverwenden
Wenn du Variablennamen für Ticket-ID und Ticketnummer angibst, stehen die Werte in nachfolgenden Nodes zur Verfügung. Die Ticketnummer ist die Nummer, wie sie in weclapp angezeigt wird. Die Integration erzeugt keinen Ticket-Link, weil weclapp dafür keine dokumentierte Adresse bereitstellt.
Bei einem ungültigen oder widerrufenen Token fordert das Dashboard eine erneute Verbindung an; die gespeicherte Konfiguration bleibt dabei erhalten. Pflichtfelder und benutzerdefinierte Attribute, die dein weclapp für Tickets vorschreibt, prüft weclapp erst beim Anlegen; ein abgelehntes Ticket erscheint mit der Begründung von weclapp im Analyse-Node. Bei hoher Last stellt weclapp Anfragen bis zu 30 Sekunden zurück und lehnt sie danach ab. smao wartet bis zu 60 Sekunden, meldet dann zu viele Anfragen und legt das Ticket 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 weclapp, ob das Ticket bereits vorhanden ist, bevor du manuell einen neuen Analyselauf startest.
In Version 1 nicht unterstützt: interne Notiz, SLA, Pooling-Gruppen, Tags, Beobachter, Zeiterfassung, benutzerdefinierte Attribute, die Verknüpfung mit Aufträgen, die öffentliche Ticketseite, Anhänge, das Aktualisieren von Tickets, Kontaktimport und mehrere weclapp-Verbindungen je Organisation. Die Integration verwendet die weclapp-API Version 2.