Die St\u00e4rke des Zoho-\u00d6kosystems liegt nicht nur in der Vielfalt seiner \u00fcber 50 Apps, sondern vor allem in ihrer F\u00e4higkeit, nahtlos miteinander zu kommunizieren. Doch was passiert, wenn kritische Daten in externen Systemen, Branchenl\u00f6sungen oder eigenentwickelten Datenbanken liegen? Viele Unternehmen stehen vor der Herausforderung, diese Datensilos aufzubrechen und eine wirklich einheitliche Systemlandschaft zu schaffen. Hier zeigt sich die wahre M\u00e4chtigkeit von Zoho: als offene Plattform, die sich \u00fcber APIs, Webhooks und die eigene Skriptsprache Deluge tief in deine bestehende IT-Infrastruktur integrieren l\u00e4sst. Dieser Artikel zeigt dir praxisnah, wie Du eine solche Br\u00fccke baust und Zoho zum zentralen Nervensystem deines Unternehmens machst.<\/p>\n
Stell dir ein typisches Szenario bei einem IT-Dienstleister oder einem Managed Services Provider (MSP) vor. Das Unternehmen nutzt Zoho CRM<\/a> f\u00fcr die Kundenverwaltung, Zoho Desk<\/a> f\u00fcr den Support und vielleicht Zoho Books<\/a> f\u00fcr die Abrechnung. Parallel dazu existiert jedoch ein spezialisiertes, vielleicht sogar selbst entwickeltes System f\u00fcr das IT-Asset-Management (ITAM). In dieser externen Datenbank sind alle Kundenger\u00e4te \u2013 Laptops, Server, Drucker \u2013 mit Seriennummern, Garantiedaten und Wartungshistorie erfasst.<\/p>\n Meldet nun ein Kunde per Ticket in Zoho Desk ein Problem mit seinem Laptop, beginnt f\u00fcr den Support-Mitarbeiter ein umst\u00e4ndlicher Prozess: Er muss das Ticketsystem verlassen, sich in das externe ITAM-System einloggen, den Kunden und das entsprechende Ger\u00e4t suchen und die relevanten Informationen manuell abgleichen. Das kostet Zeit, ist fehleranf\u00e4llig und verhindert einen schnellen, kontextbezogenen Service. Das Ziel muss also sein, die relevanten Asset-Informationen direkt im Zoho Desk Ticket anzuzeigen.<\/p>\n Wir l\u00f6sen dieses Problem, indem wir eine Custom Function in Zoho Desk erstellen. Diese Funktion ruft per API-Anfrage die Daten aus dem externen ITAM-System ab und stellt sie direkt in der Ticket-Ansicht dar. Daf\u00fcr nutzen wir die Skriptsprache Deluge.<\/p>\n Zuerst musst Du die API des externen Systems verstehen. Die meisten modernen Systeme bieten eine REST-API an. Finde Antworten auf folgende Fragen:<\/p>\n In Zoho CRM<\/a> oder Zoho Desk<\/a> solltest Du au\u00dferdem ein benutzerdefiniertes Feld anlegen, z.B. „Asset ID“, in dem die eindeutige Kennung des Ger\u00e4ts aus dem ITAM-System gespeichert wird. Diese ID ist der Schl\u00fcssel f\u00fcr die Verkn\u00fcpfung.<\/p>\n Speichere niemals API-Schl\u00fcssel direkt im Code! Zoho bietet daf\u00fcr eine sichere L\u00f6sung: Connections<\/strong>. Gehe in den Einstellungen deines Zoho-Produkts (z.B. Desk) zu Entwicklerbereich \u2192 Verbindungen \u2192 Neue Verbindung erstellen<\/em>.<\/p>\n Zoho speichert diesen Schl\u00fcssel nun sicher und verschl\u00fcsselt. In deinem Deluge-Skript verweist Du nur noch auf den Namen der Verbindung („ITAM_System_API“).<\/p>\n Jetzt kommt das Herzst\u00fcck der Integration. Wir erstellen in Zoho Desk eine Custom Function, die bei jedem \u00d6ffnen eines Tickets ausgef\u00fchrt wird und die Asset-Daten abruft. Gehe zu Einstellungen \u2192 Entwicklerbereich \u2192 Custom Functions<\/em> und erstelle eine neue Funktion.<\/p>\n Diese Funktion nimmt die Ticket-ID als Argument, holt sich die darin gespeicherte Asset-ID und ruft die externe API auf.<\/p>\n Die reine Datenabfrage reicht nicht \u2013 die Informationen m\u00fcssen f\u00fcr den Mitarbeiter sichtbar sein. Die eleganteste L\u00f6sung hierf\u00fcr ist ein Widget<\/strong> in Zoho Desk. Ein Widget ist quasi eine kleine Web-Anwendung (HTML, CSS, JavaScript), die im rechten Panel eines Tickets angezeigt wird.<\/p>\n Dein Widget-Code w\u00fcrde die soeben erstellte Deluge-Funktion aufrufen und die zur\u00fcckgegebenen Daten in einer \u00fcbersichtlichen Tabelle oder Liste darstellen.<\/p>\n Der JavaScript-Teil deines Widgets k\u00f6nnte so aussehen:<\/p>\n Mit diesen Schritten hast Du eine Live-Verbindung zwischen Zoho Desk und deinem externen System hergestellt. Dein Support-Team spart bei jedem Ticket wertvolle Minuten.<\/p>\n Diese Art der Integration ist nur der Anfang. Denk den Prozess weiter:<\/p>\n Die wahre St\u00e4rke von Zoho One<\/a> und dem gesamten \u00d6kosystem entfaltet sich erst, wenn Du die Grenzen der einzelnen Apps sprengst. Die Integration mit externen Systemen \u00fcber Deluge und APIs ist kein „Nice-to-have“, sondern ein entscheidender Schritt zur Schaffung effizienter, automatisierter und kontextbezogener Prozesse. Indem Du Daten dort verf\u00fcgbar machst, wo sie gebraucht werden, reduzierst Du manuellen Aufwand, minimierst Fehler und schaffst einen echten Mehrwert f\u00fcr Mitarbeiter und Kunden. Der gezeigte Anwendungsfall ist ein Paradebeispiel daf\u00fcr, wie Du mit gezielter Entwicklungsarbeit Datensilos einrei\u00dft und Zoho zur zentralen Datendrehscheibe deines Unternehmens ausbaust.<\/p>\n In diesem Beispiel verwendete Zoho Apps:<\/strong><\/p>\n Nutze Zoho als zentrales Nervensystem, um externe Systeme via API und Deluge effizient in deine IT-Infrastruktur zu integrieren.<\/p>\n","protected":false},"author":1,"featured_media":4197,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"ocean_post_layout":"","ocean_both_sidebars_style":"","ocean_both_sidebars_content_width":0,"ocean_both_sidebars_sidebars_width":0,"ocean_sidebar":"","ocean_second_sidebar":"","ocean_disable_margins":"enable","ocean_add_body_class":"","ocean_shortcode_before_top_bar":"","ocean_shortcode_after_top_bar":"","ocean_shortcode_before_header":"","ocean_shortcode_after_header":"","ocean_has_shortcode":"","ocean_shortcode_after_title":"","ocean_shortcode_before_footer_widgets":"","ocean_shortcode_after_footer_widgets":"","ocean_shortcode_before_footer_bottom":"","ocean_shortcode_after_footer_bottom":"","ocean_display_top_bar":"default","ocean_display_header":"default","ocean_header_style":"","ocean_center_header_left_menu":"","ocean_custom_header_template":"","ocean_custom_logo":0,"ocean_custom_retina_logo":0,"ocean_custom_logo_max_width":0,"ocean_custom_logo_tablet_max_width":0,"ocean_custom_logo_mobile_max_width":0,"ocean_custom_logo_max_height":0,"ocean_custom_logo_tablet_max_height":0,"ocean_custom_logo_mobile_max_height":0,"ocean_header_custom_menu":"","ocean_menu_typo_font_family":"","ocean_menu_typo_font_subset":"","ocean_menu_typo_font_size":0,"ocean_menu_typo_font_size_tablet":0,"ocean_menu_typo_font_size_mobile":0,"ocean_menu_typo_font_size_unit":"px","ocean_menu_typo_font_weight":"","ocean_menu_typo_font_weight_tablet":"","ocean_menu_typo_font_weight_mobile":"","ocean_menu_typo_transform":"","ocean_menu_typo_transform_tablet":"","ocean_menu_typo_transform_mobile":"","ocean_menu_typo_line_height":0,"ocean_menu_typo_line_height_tablet":0,"ocean_menu_typo_line_height_mobile":0,"ocean_menu_typo_line_height_unit":"","ocean_menu_typo_spacing":0,"ocean_menu_typo_spacing_tablet":0,"ocean_menu_typo_spacing_mobile":0,"ocean_menu_typo_spacing_unit":"","ocean_menu_link_color":"","ocean_menu_link_color_hover":"","ocean_menu_link_color_active":"","ocean_menu_link_background":"","ocean_menu_link_hover_background":"","ocean_menu_link_active_background":"","ocean_menu_social_links_bg":"","ocean_menu_social_hover_links_bg":"","ocean_menu_social_links_color":"","ocean_menu_social_hover_links_color":"","ocean_disable_title":"default","ocean_disable_heading":"default","ocean_post_title":"","ocean_post_subheading":"","ocean_post_title_style":"","ocean_post_title_background_color":"","ocean_post_title_background":0,"ocean_post_title_bg_image_position":"","ocean_post_title_bg_image_attachment":"","ocean_post_title_bg_image_repeat":"","ocean_post_title_bg_image_size":"","ocean_post_title_height":0,"ocean_post_title_bg_overlay":0.5,"ocean_post_title_bg_overlay_color":"","ocean_disable_breadcrumbs":"default","ocean_breadcrumbs_color":"","ocean_breadcrumbs_separator_color":"","ocean_breadcrumbs_links_color":"","ocean_breadcrumbs_links_hover_color":"","ocean_display_footer_widgets":"default","ocean_display_footer_bottom":"default","ocean_custom_footer_template":"","osh_disable_topbar_sticky":"default","osh_disable_header_sticky":"default","osh_sticky_header_style":"default","osh_sticky_header_effect":"","osh_custom_sticky_logo":0,"osh_custom_retina_sticky_logo":0,"osh_custom_sticky_logo_height":0,"osh_background_color":"","osh_links_color":"","osh_links_hover_color":"","osh_links_active_color":"","osh_links_bg_color":"","osh_links_hover_bg_color":"","osh_links_active_bg_color":"","osh_menu_social_links_color":"","osh_menu_social_hover_links_color":"","ocean_post_oembed":"","ocean_post_self_hosted_media":"","ocean_post_video_embed":"","ocean_link_format":"","ocean_link_format_target":"self","ocean_quote_format":"","ocean_quote_format_link":"post","ocean_gallery_link_images":"on","ocean_gallery_id":[],"footnotes":""},"categories":[1],"tags":[],"class_list":["post-4128","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-zoho","entry","has-media"],"acf":[],"yoast_head":"\nSchritt-f\u00fcr-Schritt: Externe Asset-Daten in Zoho Desk integrieren<\/h3>\n
Schritt 1: Vorbereitung und Analyse der externen API<\/h4>\n
\n
https:\/\/api.dein-itam-system.com\/v1\/assets\/{asset_id}<\/code>)?<\/li>\nAuthorization: Bearer DEIN_API_SCHLUESSEL<\/code>).<\/li>\nSchritt 2: Die Verbindung in Zoho sicher einrichten<\/h4>\n
\n
api_key<\/code>, w\u00e4hle als Ort „Header“ und gib als Header-Name „Authorization“ an.<\/li>\napi_key<\/code> einzugeben. Gib hier `Bearer DEIN_ECHTER_API_SCHLUESSEL` ein.<\/li>\n<\/ol>\nSchritt 3: Die Deluge Custom Function in Zoho Desk schreiben<\/h4>\n
\n\/\/ Funktion, um Asset-Details von einer externen API abzurufen\n\/\/ @param ticketId - Die ID des aktuellen Zoho Desk Tickets\n\nmap getAssetDetailsFromITAM(int ticketId)\n{\n \/\/ 1. Ticket-Details abrufen, um die Asset-ID zu erhalten\n ticketDetails = zoho.desk.getRecordById(ticketId, \"tickets\");\n assetId = ticketDetails.get(\"cf_asset_id\"); \/\/ Annahme: Das Custom Field hei\u00dft 'cf_asset_id'\n \n \/\/ Pr\u00fcfen, ob eine Asset-ID im Ticket hinterlegt ist\n if(assetId != null && assetId != \"\")\n {\n \/\/ 2. API-Endpunkt-URL zusammenbauen\n apiUrl = \"https:\/\/api.dein-itam-system.com\/v1\/assets\/\" + assetId;\n \n \/\/ 3. API-Aufruf mit der sicheren Verbindung durchf\u00fchren\n \/\/ \"ITAM_System_API\" ist der Name der in Zoho erstellten Connection\n response = invokeurl\n [\n url: apiUrl\n type: GET\n connection: \"ITAM_System_API\"\n ];\n \n \/\/ 4. JSON-Antwort in eine Deluge Map umwandeln und zur\u00fcckgeben\n if(response.get(\"responseCode\") == 200)\n {\n assetData = response.get(\"response\").toJSON();\n \/\/ Erstelle eine saubere Map mit den ben\u00f6tigten Infos\n resultMap = Map();\n resultMap.put(\"deviceName\", assetData.get(\"deviceName\"));\n resultMap.put(\"serialNumber\", assetData.get(\"serialNumber\"));\n resultMap.put(\"warrantyEndDate\", assetData.get(\"warrantyEndDate\"));\n resultMap.put(\"status\", \"Success\");\n return resultMap;\n }\n else\n {\n \/\/ Fehlerbehandlung: API nicht erreichbar oder Asset nicht gefunden\n errorMap = Map();\n errorMap.put(\"status\", \"Error\");\n errorMap.put(\"message\", \"Asset nicht gefunden oder API-Fehler: \" + response);\n return errorMap;\n }\n }\n \n \/\/ Keine Asset-ID im Ticket gefunden\n infoMap = Map();\n infoMap.put(\"status\", \"Info\");\n infoMap.put(\"message\", \"Keine Asset-ID im Ticket hinterlegt.\");\n return infoMap;\n}\n<\/code><\/pre>\nSchritt 4: Daten im Frontend anzeigen mit einem Widget<\/h4>\n
\n\/\/ In der widget.js Datei deines Zoho Desk Widgets\nZOHO.embeddedApp.on(\"PageLoad\", function(data) {\n \/\/ Rufe die ID des aktuell geladenen Tickets ab\n var ticketId = data.EntityId;\n\n \/\/ Rufe unsere Deluge-Funktion auf\n ZOHO.CRM.FUNCTIONS.execute(\"getAssetDetailsFromITAM\", {\"ticketId\": ticketId})\n .then(function(response) {\n \/\/ Verarbeite die Antwort der Deluge-Funktion\n var assetData = response.details.output;\n var result = JSON.parse(assetData);\n \n if(result.status == \"Success\") {\n \/\/ Baue das HTML, um die Daten anzuzeigen\n var content = \"<h4>Asset-Informationen<\/h4>\";\n content += \"<p><strong>Ger\u00e4tename:<\/strong> \" + result.deviceName + \"<\/p>\";\n content += \"<p><strong>Seriennummer:<\/strong> \" + result.serialNumber + \"<\/p>\";\n content += \"<p><strong>Garantie bis:<\/strong> \" + result.warrantyEndDate + \"<\/p>\";\n document.getElementById(\"asset-info-container\").innerHTML = content;\n } else {\n document.getElementById(\"asset-info-container\").innerText = result.message;\n }\n });\n});\n<\/code><\/pre>\nTipps und Best Practices<\/h3>\n
\n
Weitere Integrationsm\u00f6glichkeiten im Zoho-\u00d6kosystem<\/h3>\n
\n
Fazit: Mehr als nur die Summe seiner Teile<\/h3>\n
\n\n