Die Mail-API ermöglicht die Einstellung von Ticketeigenschaften durch Angabe von Befehlen in einer E-Mail-Antwort auf eine Benachrichtigung. Nur Agenten können die Mail-API in Anspruch nehmen. Wenn Endbenutzer diese Befehle verwenden, werden sie von Zendesk ignoriert.
Im folgenden Beispiel sehen Sie, wie ein Agent den Status und den zugewiesenen Mitarbeiter eines Tickets in einer Antwort auf eine E-Mail-Benachrichtigung einstellt:
Ein Agent kann die Befehle auch in einer neuen E-Mail an die Supportadresse des jeweiligen Zendesk Support-Kontos angeben. Durch diese Art von E-Mail wird ein neues Ticket erstellt.
Syntax
Die Mail-API sucht am Anfang einer E-Mail nach einer Liste von Befehlen, die ausgeführt werden sollen.
Diese Befehle müssen in reinem Textformat (nicht HTML) eingegeben werden und dem folgenden Muster entsprechen:
#Befehl Wert
Wenn Sie beispielsweise den Status eines Tickets festlegen möchten, können Sie folgenden Befehl verwenden:
#status solved
Jeder Befehl muss in einer separaten Zeile eingegeben werden. Wenn Sie beispielsweise den Status eines Tickets und den zugewiesenen Mitarbeiter festlegen möchten, können Sie folgende Befehle verwenden:
#status solved
#assignee jonas@zendesk.com
Geben Sie den Text der E-Mail nach dem Befehlsblock ein.
Befehlsreferenz
Nachfolgend sind alle unterstützten Befehle aufgelistet, die Sie in einer gültigen E-Mail verwenden können. Jeder Befehl muss in einer eigenen Zeile stehen. Die Liste enthält auch aus einem Wort bestehende Kurzbefehle, die anstelle der normalen Befehle verwendet werden können. Bei diesen Kurzbefehlen braucht kein Wert angegeben zu werden. Beispielsweise können Sie den Kurzbefehl#solvedanstelle von#status solved verwenden.
Befehl | Beschreibung |
---|---|
#status |
Gültige Werte: „open“, „pending“ und „solved“. Hinweis: Damit ein Ticket auf „solved“ (gelöst) gesetzt werden kann, muss mit „#assignee“ ein Mitarbeiter zugewiesen werden. Kurzsyntax:#open #pending #solved Hinweis: Der Befehl#solvedfunktioniert nur für Tickets ohne erforderliche Felder, die der Agent ausfüllen muss, bevor das Ticket gelöst werden kann. |
#requester | Legt den Anfordernden für das Ticket fest. Gültige Werte: die Benutzer-ID der Person in Ihrem Konto oder ihre E-Mail-Adresse. Wenn der Benutzer noch nicht in Ihrem Konto vorhanden ist, wird er von Zendesk erstellt. |
#group |
Weist das Ticket einer Gruppe zu. Gültige Werte: Name oder ID einer Gruppe. |
#assignee | Weist das Ticket einem Agenten zu. Gültige Werte: E-Mail-Adresse des Mitarbeiters oder seine Zendesk Support-ID (z. B. über eine REST-Integration abgerufen). Bei Verwendung dieses Befehls werden Sie automatisch zu einem Beitragenden (CC) im Ticket. |
#priority |
Legt die Priorität des Tickets fest. Gültige Werte: „low“, „normal“, „high“ und „urgent“. Hinweis: Sie können nur dann eine Priorität festlegen, wenn Sie auch einen Tickettyp festlegen (siehe unten). Kurzsyntax:#low #normal #high #urgent |
#type |
Gültige Werte: „incident“, „question“, „task“ und „problem“. Kurzsyntax:#incident #question #task #problem |
#tags |
Fügt Stichworte zum Ticket hinzu. Wenn Sie mehrere Stichworte auf einmal eingeben, sind diese durch Leerzeichen oder Kommas zu trennen. Hinweis: Beim Hinzufügen neuer Stichworte werden alle bereits im Ticket vorhandenen Stichworte entfernt. |
#public |
Macht die Kommentaraktualisierung im Ticket öffentlich sichtbar. Dieser Befehl kann nur beim Aktualisieren eines Tickets verwendet werden. Der Standardwert lautet „true“, d. h. der gesamte im Hauptteil der E-Mail angegebene Text ist für den Anfordernden sichtbar. Kurzsyntax:#note(privater Kommentar) |
Ungültige Befehle
Ungültige Befehle oder Werte werden von Zendesk ignoriert.
Beispiel
Im folgenden Beispiel verwendet der Agent alle verfügbaren Befehle.
Durch diese E-Mail werden in Ticket #178 folgende Aktionen durchgeführt:
- Der Status wird auf „offen“ gesetzt.
- Die Gruppe wird auf „Support“ und der Mitarbeiter auf den Agenten mit der E-Mail-Adresse „jonas@zendesk.com“ gesetzt.
- Die Priorität wird auf „normal“ gesetzt.
- Der Tickettyp wird auf „Frage“ gesetzt.
- Die Stichworte „hilfe“ und „api“ werden hinzugefügt.
- Die Sichtbarkeit des Kommentars wird auf „privat“ gesetzt.
- Der neue Kommentar „Hallo Welt!“ wird zum Ticket hinzugefügt. Er – und die Befehle darüber – sind für den Anfragenden nicht sichtbar.
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.