Datto Anbindung

Generelle Informationen

Was ist die Datto Anbindung?

DocBee bietet Ihnen die Möglichkeit, Kunden-Objekte aus dem Monitoring-Tool Datto anzulegen, Vorgänge bei Alarmen zu produzieren und die Alarme durch Schließen des Vorgangs zurückzusetzen.

Wann sollten Sie Datto Anbindung verwenden?

Falls Sie Datto als Monitoring-Tool verwenden.

Einrichtung

Um die Datto Anbindung zu aktiveren, müssen Sie unter Administration > Anbindungen > Datto RMM die Einstellungen bzw. Verknüpfungen vornehmen.

Einstellungen

Die Einstellungen definieren das generelle Verhalten der Datto Anbindung und ob diese überhaupt aktiviert ist.

Name	Beschreibung
Aktiviert	Definiert, ob die Datto Anbindung aktiv ist oder nicht
Url	Datto API URL. Zum Beispiel: https://ihrdatto.com/api/
Alle Zertifikate erlauben	Definiert, ob alle Zertifikate (auch Self-Signed Zertifikate) erlaubt sind (Wir empfehlen das Hinterlegen von gültigen Zertifikaten und damit das Deaktivieren dieser Funktion)
Api Key	Der Api Key, den Sie aus Ihrem Datto erhalten haben
Api Secret Key	Der Api Secret Key, den Sie aus Ihrem Datto erhalten haben
Kunden-Objekte anlegen?	Falls Sie dies aktivieren, versucht DocBee automatisch Kunden-Objekte aus den Datto Daten anzulegen.
zurücksetzen	Falls Sie dies aktivieren, wird falls Sie den DocBee Vorgang schließen der Alarm in Datto zurückgesetzt.
Objekt	Wählen Sie hier ein DocBee Objekt (Anlegbar unter Verwaltung > Objekte) aus, welches für Objekte aus Datto verwendet werden soll. Die Kategorie des Objektes muss Monitoring unterstützen.
Nicht automatisch änderbare Status	Ein Status, der hier ausgewählt ist, kann durch Datto nicht geändert werden.
Webhook-URL	Dieser Link wird vom System generiert und als URL in den Alarmen in Datto hinterlegt.

Verknüpfung

Damit DocBee Kunden-Objekte für Sie anlegen kann, muss noch eine Verknüpfung zwischen den DocBee Kunden und den Datto Daten erstellt werden. Diese Verknüpfung machen Sie in DocBee im Untermenü Verknüpfungen. Hier können Sie via Sammelaktion den jeweiligen Datto-Daten DocBee Kunden / Standorte bzw. Kontakten zuweisen.

Einrichtung in Datto

Damit in DocBee Vorgänge angelegt bzw. Aktualisierungen von Vorgängen vorgenommen werden können, muss in Datto das Senden eines Webhooks eingerichtet werden.

Einrichtung eines Webhooks

Die Einrichtung eines Webhooks in Datto wird in der Datto RMM Dokumentation erklärt.

1. Wir empfehlen das Feld When Alert is Resolved (Optional) zu aktivieren um unterschiedliche Nutzlasten bei einem neuen Vorgang und beim Schließen eines Vorgangs zu definieren.
2. In dem Feld URL geben Sie die Webhook-URL aus DocBee ein.
3. Der Content Type, den Sie auswählen bleibt Ihnen überlassen. Abhängig vom Content Type ändert sich jedoch die Payload. Das untere Beispiel nutzt den Content Type application/x-www-form-urlencoded.

Webhook Payloads

Die Nutzlast (payload) beim Webhook definiert die Daten die an DocBee übergeben werden, um Vorgänge anzulegen oder zu aktualisieren. Diese Nutzlast besteht aus einem Pflichtteil, den DocBee zur korrekten Verarbeitung benötigt und weiteren optionalen Daten um Ihr gewünschtes Verhalten zu definieren. Aus diesen Daten ergibt sich dann z.B. folgender Aufbau der unter Payload eingetragen werden muss.

alertUid=[alert_uid]
&deviceUid=[device_uid]
&deviceName=[device_hostname]
&description=[device_description]
&docbee_status_id=2
&docbee_category_id=10

Wie Sie sehen können verwendet diese Nutzlast (payload) Platzhalter die direkt aus Datto befüllt werden bevor die Daten verschickt werden.

Bis auf beim ersten Feld muss immer ein & vorangestellt werden damit die Daten richtig zu DocBee übertragen werden

Die IDs bei docbee_status_id und docbee_category_id sind Beispiele und müssen durch Ihre Werte ersetzt werden.

Pflichtteil

Name	Wert	Beschreibung
alertUid	[alert_uid]	Verwendet den Datto Platzhalter um die ID des Alarms an DocBee zu schicken. Diese ID ermöglicht es, einen existierenden nicht geschlossenen Vorgang zu finden und diese zu Aktualisieren anstelle der Anlage eines neuen Vorgangs
deviceUid	[device_uid]	Verwendet den Datto Platzhalter um die ID des Gerätes an DocBee zu schicken. Dieses ermöglicht die Bestimmung des Kunden, Standort, Kontaktes und Kunden-Objekt beim Anlegen von neuen Vorgängen (Verknüpfung der Geräte innerhalb von DocBee vorausgesetzt)
deviceName	[device_hostname]	Verwendet den Datto Platzhalter um einen Namen des Gerätes zu erhalten um diesen in DocBee anzuzeigen
description	[device_description]	Verwendet den Datto Platzhalter um die die Beschreibung des Gerätes zu erhalten um diese in DocBee anzuzeigen

Optionaler Teil

Der optionale Teil definiert zusätzliche Daten, um das Verhalten zu innerhalb von DocBee zu definieren

Name	Wert	Beschreibung
docbee_status_id	ID	Die DocBee ID eines Status, die gesetzt werden soll, falls diese Benachrichtigung ausgelöst wird. Falls nicht gesetzt wird der Standard Offen Status bei neuen Vorgängen verwendet und bei Aktualisierungen eines Vorgangs wird keine Änderung vorgenommen.
docbee_priority_id	ID	Die DocBee ID einer Priorität, die gesetzt werden soll, falls diese Benachrichtigung ausgelöst wird. Falls nicht gesetzt wird die Standard Priorität bei neuen Vorgängen verwendet und bei Aktualisierungen eines Vorgangs wird keine Änderung vorgenommen.
docbee_owner_id	ID	Die DocBee ID eines Benutzers oder einer Queue, die gesetzt werden soll, falls diese Benachrichtigung ausgelöst wird. Falls nicht gesetzt wird bei neuen Vorgängen keine Verantwortlicher gesetzt und bei Aktualisierungen eines Vorgangs wird keine Änderung vorgenommen.
docbee_category_id	ID	Die DocBee ID der Vorgangs-Kategorie, die gesetzt werden soll, falls diese Benachrichtigung ausgelöst wird. Falls nicht gesetzt wird bei neuen Vorgängen keine Kategorie gesetzt und bei Aktualisierungen eines Vorgangs wird keine Änderung vorgenommen.
docbee_department_id	ID	Die DocBee ID der Abteilung, die gesetzt werden soll, falls diese Benachrichtigung ausgelöst wird. Falls nicht gesetzt wird bei neuen Vorgängen keine Abteilung gesetzt und bei Aktualisierungen eines Vorgangs wird keine Änderung vorgenommen.
docbee_tag_id	ID	Die DocBee ID eines Tags, die gesetzt werden soll, falls diese Benachrichtigung ausgelöst wird. Falls nicht gesetzt wird bei neuen Vorgängen keine Tag gesetzt. Beim Aktualisieren wird dieser Wert nicht berücksichtigt

Monitors in Datto

Damit DocBee Vorgänge anlegt bzw. aktualisiert, müssen in Datto sogenannte Monitors angelegt werden. Dabei sollte unter Response die Option Send a Webhook aktiviert werden.

FAQ

Wie häufig findet eine Daten-Synchronisation statt?

Aktuell werden Daten aus Datto einmal pro Stunde aktualisiert.

Warum legt DocBee keine Vorgänge an?

Um das Problem zu lösen, prüfen Sie bitte folgende Schritte

1. Haben Sie einen Monitor anlegt?
2. Ist der Monitor eventuell nicht enabled?
3. Wurde der Webhook im Monitor hinterlegt?
4. Prüfen Sie, ob im Fehlerprotokoll ein Datto Fehler vorliegt.

Wie finde ich die DocBee Status ID heraus?

Zum Herausfinden der Status ID können Sie in DocBee den gewünschten Status in der Administration öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/status/edit/<STATUS_ID>.

Wie finde ich die DocBee Priorität ID heraus?

Zum Herausfinden der Priorität ID können Sie in DocBee die gewünschte Priorität in der Administration öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/priority/edit/<PRIORITY_ID>.

Wie finde ich die DocBee Vorgangs-Kategorie ID heraus?

Zum Herausfinden der Priorität ID können Sie in DocBee die gewünschte Priorität in der Administration öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/ticketCategory/edit/<CATEGORY_ID>.

Wie finde ich die DocBee Abteilung ID heraus?

Zum Herausfinden der Abteilung ID können Sie in DocBee die gewünschte Abteilung in der Administration öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/department/edit/<ABTEILUNG_ID>.

Wie finde ich die DocBee Benutzer ID heraus?

Zum Herausfinden der Benutzer ID können Sie in DocBee den gewünschten Benutzer in der Verwaltung öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/user/edit/<BENUTZER_ID>.

Wie finde ich die DocBee Queue ID heraus?

Zum Herausfinden der Queue ID können Sie in DocBee die gewünschte Queue in der Verwaltung öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/queue/edit/<QUEUE_ID>.

Wie finde ich die DocBee Tag ID heraus?

Zum Herausfinden der Tag ID können Sie in DocBee den gewünschten Tag in der Administration öffnen und dort die ID aus der Browser Adresszeile kopieren https://www.ihredocbeedomain.com/tag/edit/<TAG_ID>.