In unserem Tech-Tipp der Woche zeigen wir Ihnen, wie Sie in HaloPSA ein benutzerdefiniertes Integrations-Runbook einrichten, mit dem Sie bei der Erstellung eines Tickets einen Artikel oder ein Produkt mit ausgeben können. Mit diesem Prozess können Sie ein Abrechnungsmodell mit fester Gebühr für bestimmte Ticketarten erstellen, z. B. für die Einrichtung neuer Hardware.
Einrichten des Integrations-Runbooks
Um das Integrations-Runbook manuell zu erstellen (oder die oben genannte Vorlage zu importieren), gehen Sie zu
- Config > Integrations > Custom Integrations > New
- /config/integrations/customintegrations/runbooks?id=-1
Benennen Sie das Integrations-Runbook und speichern Sie es ab. Falls erforderlich, können Sie anschließend das JSON-Skript importieren. Drücken Sie danach auf edit und gehen Sie zum flow chart.
| 1 | { |
| 2 | „id“: null, |
| 3 | „name“: „Issue Item“, |
| 4 | „type“: 1, |
| 5 | „content_type“: „application/json“, |
| 6 | „authentication_type“: 0, |
| 7 | „method“: 0, |
| 8 | „certificate_id“: 0, |
| 9 | „certificate_name“: „“, |
| 10 | „active“: true, |
| 11 | „events“: [], |
| 12 | „last_status“: 1, |
| 13 | „systemuse“: „“, |
| 14 | „runbook_start_type“: 0, |
| 15 | „inbound_authentication_type“: 0, |
| 16 | „algorithm“: 0, |
| 17 | „digest“: 0, |
| 18 | „custom_payload“: false, |
| 19 | „flow_chart_json“: „{\“id\“:\“a8d8239e-5a07-4e88-8252-0c89768e75e0\“,\“offsetX\“:14,\“offsetY\“:1,\“zoom\“:100,\“gridSize\“:25,\“links\“:[{\“id\“:\“7ed17b1d-a272-4333-b67b-fcca2a80f743\“,\“_class\“:\“LinkModel\“,\“selected\“:false,\“type\“:\“default\“,\“source\“:\“node_1\“,\“sourcePort\“:\“node_1_port_1\“,\“target\“:\“node_2\“,\“targetPort\“:\“9957c0d0-38eb-4f8d-a127-8fbd6989a13d\“,\“points\“:[{\“id\“:\“c5fd48ec-ed4a-4430-b8fb-3c161fa6f0e2\“,\“_class\“:\“PointModel\“,\“selected\“:false,\“x\“:235.5625,\“y\“:210.75},{\“id\“:\“809734c2-b6d0-4c6e-a986-aebc4f7638bc\“,\“_class\“:\“PointModel\“,\“selected\“:false,\“x\“:283.5,\“y\“:185}],\“extras\“:{}},{\“id\“:\“027d471e-d38a-4d69-b238-62918f8901b8\“,\“_class\“:\“LinkModel\“,\“selected\“:false,\“type\“:\“default\“,\“source\“:\“node_1\“,\“sourcePort\“:\“node_1_port_2\“,\“target\“:\“node_3\“,\“targetPort\“:\“24223439-f7a5-4d2e-9148-c2480af9cd02\“,\“points\“:[{\“id\“:\“242dc091-2a9b-4c0e-a975-ef19b7f80086\“,\“_class\“:\“PointModel\“,\“selected\“:false,\“x\“:235.5625,\“y\“:228.25},{\“id\“:\“03e91043-d714-4b0c-9f20-0a334e442b69\“,\“_class\“:\“PointModel\“,\“selected\“:false,\“x\“:283.5,\“y\“:339}],\“extras\“:{}},{\“id\“:\“7d0e7770-e231-48a0-bbb4-012e7abab985\“,\“_class\“:\“LinkModel\“,\“selected\“:false,\“type\“:\“default\“,\“source\“:\“node_2\“,\“sourcePort\“:\“node_2_port_1\“,\“target\“:\“node_4\“,\“targetPort\“:\“c5c7fcee-d7eb-48b6-85ab-745cb45daab8\“,\“points\“:[{\“id\“:\“49e9c321-5c16-491f-8fd5-301a020b8d48\“,\“_class\“:\“PointModel\“,\“selected\“:false,\“x\“:410.5625,\“y\“:185.75},{\“id\“:\“022618d2-6343-4c74-9337-b18c9b209838\“,\“_class\“:\“PointModel\“,\“selected\“:false,\“x\“:458.5,\“y\“:189}],\“extras\“:{}},{\“id\“:\“79538db7-6048-4073-b020-aa945f27f1e6\“,\“_class\“:\“LinkModel\“,\“selected\“:false,\“type\“:\“default\“,\“source\“:\“node_2\“,\“sourcePort\“:\“node_2_port_2\“,\“target\“:\“node_4\“,\“targetPort\“:\“c5c7fcee-d7eb-48b6-85ab-745cb45daab8\“,\“points\“:[{\“id\“:\“280547b3-d9f0-456e-a8e6-957443defc48\“,\“_class\“:\“PointModel\“,\“selected\“:false,\“x\“:410.5625,\“y\“:203.25},{\“id\“:\“19f21907-0ef7-42b3-87fa-ebcb180f748c\“,\“_class\“:\“PointModel\“,\“selected\“:false,\“x\“:458.5,\“y\“:189}],\“extras\“:{}}],\“nodes\“:[{\“id\“:\“node_1\“,\“_class\“:\“DefaultNodeModel\“,\“selected\“:false,\“type\“:\“default\“,\“x\“:100,\“y\“:100,\“extras\“:{},\“ports\“:[{\“id\“:\“f8a4880b-39c5-44f7-b20e-6856fd042256\“,\“_class\“:\“DefaultPortModel\“,\“selected\“:false,\“name\“:\“in\“,\“parentNode\“:\“node_1\“,\“links\“:[],\“in\“:true,\“label\“:\“ \“},{\“id\“:\“node_1_port_1\“,\“_class\“:\“DefaultPortModel\“,\“selected\“:false,\“name\“:\“node_1_port_1\“,\“parentNode\“:\“node_1\“,\“links\“:[\“7ed17b1d-a272-4333-b67b-fcca2a80f743\“],\“in\“:false,\“label\“:\“Successful\“},{\“id\“:\“node_1_port_2\“,\“_class\“:\“DefaultPortModel\“,\“selected\“:false,\“name\“:\“node_1_port_2\“,\“parentNode\“:\“node_1\“,\“links\“:[\“027d471e-d38a-4d69-b238-62918f8901b8\“],\“in\“:false,\“label\“:\“Unsuccessful\“}],\“color\“:\“rgb(192,255,0)\“},{\“id\“:\“node_2\“,\“_class\“:\“DefaultNodeModel\“,\“selected\“:false,\“type\“:\“default\“,\“x\“:275,\“y\“:75,\“extras\“:{},\“ports\“:[{\“id\“:\“9957c0d0-38eb-4f8d-a127-8fbd6989a13d\“,\“_class\“:\“DefaultPortModel\“,\“selected\“:false,\“name\“:\“in\“,\“parentNode\“:\“node_2\“,\“links\“:[\“7ed17b1d-a272-4333-b67b-fcca2a80f743\“],\“in\“:true,\“label\“:\“ \“},{\“id\“:\“node_2_port_1\“,\“_class\“:\“DefaultPortModel\“,\“selected\“:false,\“name\“:\“node_2_port_1\“,\“parentNode\“:\“node_2\“,\“links\“:[\“7d0e7770-e231-48a0-bbb4-012e7abab985\“],\“in\“:false,\“label\“:\“Successful\“},{\“id\“:\“node_2_port_2\“,\“_class\“:\“DefaultPortModel\“,\“selected\“:false,\“name\“:\“node_2_port_2\“,\“parentNode\“:\“node_2\“,\“links\“:[\“79538db7-6048-4073-b020-aa945f27f1e6\“],\“in\“:false,\“label\“:\“Unsuccessful\“}],\“color\“:\“#73D8FF\“},{\“id\“:\“node_3\“,\“_class\“:\“DefaultNodeModel\“,\“selected\“:false,\“type\“:\“default\“,\“x\“:275,\“y\“:250,\“extras\“:{},\“ports\“:[{\“id\“:\“24223439-f7a5-4d2e-9148-c2480af9cd02\“,\“_class\“:\“DefaultPortModel\“,\“selected\“:false,\“name\“:\“in\“,\“parentNode\“:\“node_3\“,\“links\“:[\“027d471e-d38a-4d69-b238-62918f8901b8\“],\“in\“:true,\“label\“:\“ \“}],\“color\“:\“#F44E3B\“},{\“id\“:\“node_4\“,\“_class\“:\“DefaultNodeModel\“,\“selected\“:false,\“type\“:\“default\“,\“x\“:450,\“y\“:100,\“extras\“:{},\“ports\“:[{\“id\“:\“c5c7fcee-d7eb-48b6-85ab-745cb45daab8\“,\“_class\“:\“DefaultPortModel\“,\“selected\“:false,\“name\“:\“in\“,\“parentNode\“:\“node_4\“,\“links\“:[\“7d0e7770-e231-48a0-bbb4-012e7abab985\“,\“79538db7-6048-4073-b020-aa945f27f1e6\“],\“in\“:true,\“label\“:\“ \“}],\“color\“:\“#F44E3B\“}]}“, |
| 20 | „library_licence_name“: „“, |
| 21 | „major_version_number“: 0, |
| 22 | „minor_version_number“: 0, |
| 23 | „patch_version_number“: 0, |
| 24 | „version_number“: „0.0.0“, |
| 25 | „steps“: [ |
| 26 | { |
| 27 | „fdid“: 268, |
| 28 | „step_id“: 1, |
| 29 | „flow_id“: 0, |
| 30 | „chatprofile_id“: null, |
| 31 | „name“: „Issue Item“, |
| 32 | „isstart“: true, |
| 33 | „isend“: false, |
| 34 | „stage_number“: 0, |
| 35 | „pipeline_stage_name“: „“, |
| 36 | „actions“: [ |
| 37 | { |
| 38 | „id“: null, |
| 39 | „flow_id“: 0, |
| 40 | „chatprofile_id“: null, |
| 41 | „start_step“: 1, |
| 42 | „end_step“: 2, |
| 43 | „action_type“: 18, |
| 44 | „action_id“: -18, |
| 45 | „action_name“: „Successful“, |
| 46 | „action_outcome“: „“, |
| 47 | „use_work_hours“: true, |
| 48 | „time_limit_action_name“: „“, |
| 49 | „automation_action_name“: „“, |
| 50 | „automation_runbook_name“: „“, |
| 51 | „seq“: 1, |
| 52 | „approval_result“: 1, |
| 53 | „restricted“: false, |
| 54 | „conditions“: [], |
| 55 | „conditions_exec“: [], |
| 56 | „restrictions“: [], |
| 57 | „todo_group_name“: „“ |
| 58 | }, |
| 59 | { |
| 60 | „id“: null, |
| 61 | „flow_id“: 0, |
| 62 | „chatprofile_id“: null, |
| 63 | „start_step“: 1, |
| 64 | „end_step“: 3, |
| 65 | „action_type“: 18, |
| 66 | „action_id“: -18, |
| 67 | „action_name“: „Unsuccessful“, |
| 68 | „action_outcome“: „“, |
| 69 | „use_work_hours“: true, |
| 70 | „time_limit_action_name“: „“, |
| 71 | „automation_action_name“: „“, |
| 72 | „automation_runbook_name“: „“, |
| 73 | „seq“: 2, |
| 74 | „approval_result“: 0, |
| 75 | „restricted“: false, |
| 76 | „conditions“: [], |
| 77 | „conditions_exec“: [], |
| 78 | „restrictions“: [], |
| 79 | „todo_group_name“: „“ |
| 80 | } |
| 81 | ], |
| 82 | „steptype“: 2, |
| 83 | „message“: „{\n \“id\“: <<ticket^id>>,\n \“items_issued\“ : [\n {\n \“item_id\“: 20,\n \“costprice\“: 0,\n \“price\“: 75,\n \“quantity\“: 1,\n \“quantity_shipped\“: 1\n\n }\n ]\n}“, |
| 84 | „auto_action“: 8, |
| 85 | „auto_action_type“: 2, |
| 86 | „input_field_id“: 0, |
| 87 | „rules“: [], |
| 88 | „chat_image_type“: 0, |
| 89 | „newticket_service_id“: 0, |
| 90 | „output_variables“: [] |
| 91 | }, |
| 92 | { |
| 93 | „fdid“: 269, |
| 94 | „step_id“: 2, |
| 95 | „flow_id“: 0, |
| 96 | „chatprofile_id“: null, |
| 97 | „name“: „Inform Agent“, |
| 98 | „isstart“: false, |
| 99 | „isend“: false, |
| 100 | „stage_number“: 0, |
| 101 | „pipeline_stage_name“: „“, |
| 102 | „actions“: [ |
| 103 | { |
| 104 | „id“: null, |
| 105 | „flow_id“: 0, |
| 106 | „chatprofile_id“: null, |
| 107 | „start_step“: 2, |
| 108 | „end_step“: 4, |
| 109 | „action_type“: 18, |
| 110 | „action_id“: -18, |
| 111 | „action_name“: „Successful“, |
| 112 | „action_outcome“: „“, |
| 113 | „use_work_hours“: true, |
| 114 | „time_limit_action_name“: „“, |
| 115 | „automation_action_name“: „“, |
| 116 | „automation_runbook_name“: „“, |
| 117 | „seq“: 1, |
| 118 | „approval_result“: 1, |
| 119 | „restricted“: false, |
| 120 | „conditions“: [], |
| 121 | „conditions_exec“: [], |
| 122 | „restrictions“: [], |
| 123 | „todo_group_name“: „“ |
| 124 | }, |
| 125 | { |
| 126 | „id“: null, |
| 127 | „flow_id“: 0, |
| 128 | „chatprofile_id“: null, |
| 129 | „start_step“: 2, |
| 130 | „end_step“: 4, |
| 131 | „action_type“: 18, |
| 132 | „action_id“: -18, |
| 133 | „action_name“: „Unsuccessful“, |
| 134 | „action_outcome“: „“, |
| 135 | „use_work_hours“: true, |
| 136 | „time_limit_action_name“: „“, |
| 137 | „automation_action_name“: „“, |
| 138 | „automation_runbook_name“: „“, |
| 139 | „seq“: 2, |
| 140 | „approval_result“: 0, |
| 141 | „restricted“: false, |
| 142 | „conditions“: [], |
| 143 | „conditions_exec“: [], |
| 144 | „restrictions“: [], |
| 145 | „todo_group_name“: „“ |
| 146 | } |
| 147 | ], |
| 148 | „steptype“: 2, |
| 149 | „message“: „{\n \“ticket_id\“: <<ticket^id>>,\n \“outcome\“: \“Fixed Fee Applied\“,\n \“who\“: \“Automation\“,\n \“hiddenfromuser\“: true,\n \“note_html\“: \“Fixed fee applied successfully\“\n}“, |
| 150 | „auto_action“: 8, |
| 151 | „auto_action_type“: 3, |
| 152 | „input_field_id“: 0, |
| 153 | „rules“: [], |
| 154 | „chat_image_type“: 0, |
| 155 | „newticket_service_id“: 0, |
| 156 | „output_variables“: [] |
| 157 | }, |
| 158 | { |
| 159 | „fdid“: 270, |
| 160 | „step_id“: 3, |
| 161 | „flow_id“: 0, |
| 162 | „chatprofile_id“: null, |
| 163 | „name“: „Failed“, |
| 164 | „isstart“: false, |
| 165 | „isend“: true, |
| 166 | „stage_number“: 0, |
| 167 | „pipeline_stage_name“: „“, |
| 168 | „actions“: [], |
| 169 | „steptype“: 3, |
| 170 | „auto_action“: 1, |
| 171 | „input_field_id“: 0, |
| 172 | „rules“: [], |
| 173 | „chat_image_type“: 0, |
| 174 | „newticket_service_id“: 0 |
| 175 | }, |
| 176 | { |
| 177 | „fdid“: 275, |
| 178 | „step_id“: 4, |
| 179 | „flow_id“: 0, |
| 180 | „chatprofile_id“: null, |
| 181 | „name“: „Success“, |
| 182 | „isstart“: false, |
| 183 | „isend“: true, |
| 184 | „stage_number“: 0, |
| 185 | „pipeline_stage_name“: „“, |
| 186 | „actions“: [], |
| 187 | „steptype“: 3, |
| 188 | „auto_action“: 0, |
| 189 | „input_field_id“: 0, |
| 190 | „rules“: [] |
| 191 | } |
| 192 | ], |
| 193 | „input_variables“: [], |
| 194 | „disabled“: false, |
| 195 | „___loaded_at“: „2024-01-08T13:11:35.196Z“, |
| 196 | „access_control“: null |
| 197 | } |
Schritt 1 – Erstellen der Issue Item-Method
Die erste Method, die wir erstellen müssen, wird den Artikel ausgeben, der später auf dem Ticket erscheinen soll.
Hierzu erstellen Sie eine neue Halo-API-Action und setzen die Action auf Update Ticket. Nachfolgend geben Sie den folgenden JSON-Text ein:
| 1 | { |
| 2 | “id”: <<ticket^id>>, |
| 3 | “items_issued”: [ |
| 4 | { |
| 5 | “item_id”: 20, |
| 6 | “costprice”: 0, |
| 7 | “price”: 75, |
| 8 | “quantity”: 1, |
| 9 | “quantity_shipped”: 1 |
| 10 | |
| 11 | } |
| 12 | ] |
| 13 | } |
Schritt 2 – Info-Benachrichtigung für die Mitarbeiter erstellen
Als Nächstes erstellen wir für das Ticket eine individuelle Benachrichtigung, die den Mitarbeiter darüber informiert, dass eine feste Gebühr erhoben wurde.
Erstellen Sie eine neue Halo-API-Action und setzen Sie diese auf Create Action. Geben Sie den folgenden JSON-Text ein:
| 1 | { |
| 2 | “ticket_id”: <<ticket^id>>, |
| 3 | “outcome”: “Fixed Fee Applied”, |
| 4 | “who”: “Automation”, |
| 5 | “hiddenfromuser”: true, |
| 6 | “note_html”: “Fixed fee applied sucessfully” |
| 7 | } |
Anschließend müssen Sie die Ergebnisse von Erfolg und Misserfolg den Schritten failure und success zuordnen.
Erstellen einer neuen Aktion und Konfiguration der Action Settings
Als Nächstes erstellen Sie wie folgt eine neue Action in HaloPSA:
- /config/tickets/outcomes?id=-1
In den Reitern Outcome Description und Button Name sollte jeweils der Text Issue Item eingetragen sein.
Erstellen Sie eine Ergebnisbeschreibung oder einen Ergebnisnamen und geben Sie beim Reiter System Use den Text Send Webhook/Queue Integration Runbook ein. Beim Reiter Webhook/Integration Runbook sollte der Text Issue Item stehen. Anschließend müssen Sie einen Haken bei is a Quick Action setzen.
Workflow-Konfiguration mit Quick Actions
Nun fügen Sie die zuvor erstellte Action in der Maske Workflow einem Workflow als automation mit dem Typ Quick Action hinzu. Alternativ können Sie das Integrations-Runbook direkt von der Seite aus ausführen, aber in der Regel ist es schneller, dazu eine Quick Action zu nutzen.
Der finale Workflow sollte so aussehen, dass
- im ersten Schritt das Item mit der Fixed Fee angewendet wird und anschließend eine Triage für die Ticket Claims folgt,
- im zweiten Schritt das erstellte Ticket In Progress ist und dem Mitarbeiter verschiedene Auswahlmöglichkeiten zum Bearbeitungsstatus des Tickets vorgegeben sind und schließlich
- im dritten Schritt der Mitarbeiter das Ticket entweder schließen, wiedereröffnen oder kommentieren kann.
Ticket-Regel und finale Prüfung
Zuletzt müssen Sie eine Ticketregel erstellen, die den zuvor erstellten Workflow auf der Grundlage des ausgewählten Fixed Fee Type ändert. Dazu müssen Sie bei der Erstellung der Ticketregel darauf achten, dass Sie im Abschnitt Criteria den richtigen Fixed Fee Type einsetzen. Im Bereich Outcome muss nun im Feld Workflow der Name des zuvor erstellten Workflows eingesetzt werden. Ist die Konfiguration erfolgreich abgeschlossen, sollten Sie sehen, dass automatisch ein Produkt/Artikel für das Ticket ausgestellt wird, sobald ein neues Ticket mit diesem Typ protokolliert wird.
Mehr erfahren
Möchten Sie weitere Vorteile von HaloPSA gerne kennenlernen? Dann nehmen Sie an unserem kostenlosen Webinar teil und sichern Sie sich noch heute Ihre persönliche Testversion. Gerne beantworten wir Ihre Fragen auch persönlich unter +49 6441 67118-844 oder per E-Mail.