So richten Sie den Helpdeskapi-Ticket-Parser für Zendesk ein

<h3>1. Schritt - Erstellen eines Webhooks in Zendesk-Admin</h3> <a href="https://con-leafworks.zendesk.com/admin/apps-integrations/webhooks/webhooks" target="_self" rel="undefined">https://con-leafworks.zendesk.com/admin/apps-integrations/webhooks/webhooks</a> <ul> <li>Endpunkt-URL: <a href="https://helpdeskapi.com/zentools/mailparser">https://helpdeskapi.com/zentools/mailparser</a> </li> <li>Anforderungsmethode: POST</li> <li>Format der Anfrage: JSON</li> <li>Authentifizierung: Einfache Authentifizierung</li> <li>Benutzername: Ihr Helpdeskapi-Benutzername. Wenn Sie noch keinen haben, kontaktieren Sie uns bitte.</li> <li>Passwort: Ihr Helpdeskapi-Passwort</li> </ul> <img src="https://support.leafworks.de/hc/article_attachments/4410500438162/mceclip0.png" alt="mceclip0.png"> <h3>2. Schritt - Trigger erstellen, um Daten an das Helpdeskapi zu senden</h3> <a href="https://con-leafworks.zendesk.com/agent/admin/triggers">https://YOURINSTANCE.zendesk.com/agent/admin/triggers</a> Verwenden Sie "Ticket ist erstellt" als Bedingung, um die Anfrage nur einmal pro Ticket zu senden. Fügen Sie je nach Ihren Anforderungen weitere Bedingungen hinzu. <img src="https://support.leafworks.de/hc/article_attachments/360012986460/mceclip0.png" alt="mceclip0.png"> Fügen Sie Action mit "Notify active webhook" und den in Schritt 1 erstellten Webhook hinzu. <img src="https://support.leafworks.de/hc/article_attachments/4410513453586/mceclip2.png" alt="mceclip2.png"> <h4>Beispiel für ein JSON-Format</h4> <pre>{ "type": "parse.text", "ticketid":"{{ticket.id}}", "zdsourcefield": "{{ticket.title}} {{ticket.description}}", "search": [ { "regexpattern": "(^|\\W)\\s*(3[01]|[12][0-9]|0?[1-9])\\.(1[012]|0?[1-9])\\.((?:19|20)\\d{2})\\s*($|\\W)", "zddestfield": "360003363580", "settag": "case1" }, { "regexpattern": "(?:^|\\s*)(ORDER-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{8})(?:$|\\s*)", "zddestfield": "360005712999", "replace_from_match": [{ "search_string": "ORDER-", "replace_string": "" }], "settag": "case2" } ], "zdurl": "https://YOURINSTANCE.zendesk.com", "zduser": "your@user-email.com", "zdtoken": "EEMemFg1T78Heo2iZcve1GaUCMDSwaEuEStEjj2t" }</pre> <h4>Elemente der JSON-Struktur</h4> <ul> <li> Typ: Auf "parse.text" setzen</li> <li> ticketid: Wird auf "{{ticket.id}}" gesetzt. Wird durch die Ticket-ID aus dem Ticket ersetzt</li> <li> zdsourcefield: Inhalt, der nach dem zu analysierenden Text durchsucht werden soll. In den meisten Fällen kann dieser Wert auf "{{ticket.title}} {{ticket.description}}" gesetzt werden, um in einer einzigen Anfrage den Betreff und die Beschreibung des Tickets zu durchsuchen</li> <li> Suche: Array mit regulären Ausdrücken, um die benutzerdefinierten Ticketfelder zu finden, die gefundenen Werte werden gespeichert. Jedes Element kann die folgenden Parameter enthalten: <ul> <li> regexpattern: Der reguläre Ausdruck, nach dem Sie suchen möchten. Zum Erstellen des regulären Ausdrucks können Sie <a href="https://regex101.com/">https://regex101.com/</a> verwenden <a href="https://regex101.com/">.</a> HINWEIS: Schliessen Sie jeden Backslash "\" immer mit einem zusätzlichen Backslash ab. Andernfalls kann der reguläre Ausdruck nicht aus JSON-Daten verarbeitet werden.</li> <li> zddestfield: (Optional - entweder zddestfield ODER settag müssen vorhanden sein). ID des benutzerdefinierten Ticketfelds, in dem der gefundene Wert im Ticket gespeichert werden soll.</li> <li> settag: (Optional - entweder zddestfield ODER settag müssen vorhanden sein). Wenn ein Wert für den regulären Ausdruck gefunden wird, wird dieses Tag zum Ticket hinzugefügt.</li> <li> replace_from_match: (Optional). Paare von Suchwerten(search_string) und Ersetzungswerten(replace_string). Wenn diese gefunden werden, wird der Suchwert durch den Ersetzungswert ersetzt. Wenn Sie zum Beispiel nur die Bestellnummer im benutzerdefinierten Feld aus der gefundenen Zeichenfolge "ORDER-123456789" speichern möchten, können Sie search_string auf "ORDER-" und eine leere Zeichenfolge als replace_string setzen. Auf diese Weise wird das Präfix entfernt, bevor der Wert im benutzerdefinierten Ticketfeld gespeichert wird. HINWEIS: Der Suchwert kann ein regulärer Ausdruck sein. </li> </ul> </li> <li> zdurl: Die Basis-URL Ihrer Zendesk-Instanz <a href="https://YOURINSTANCE.zendesk.com">https://YOURINSTANCE.zendesk.com</a> </li> <li> zduser: Eine Benutzer-E-Mail, die berechtigt ist, Tickets zu aktualisieren. Der Benutzer wird in den Ticketereignissen für die Aktualisierung von benutzerdefinierten Feldwerten angezeigt.</li> <li> zdtoken: API-Token, der für die Aktualisierung des Tickets verwendet wird. Kann unter <a href="https://con-leafworks.zendesk.com/agent/admin/api/settings">https://YOURINSTANCE.zendesk.com/agent/admin/api/settings</a>erstellt werden. </li> </ul> <h4>Fehlerbehandlung</h4> Alle Fehler werden in den Zielfehlern Ihrer Zendesk-Instanz angezeigt <a href="https://con-leafworks.zendesk.com/agent/admin/api/target_failures">https://YOURINSTANCE.zendesk.com/agent/admin/api/target_failures</a>