Autotask - Printable Version +- ScanCircle (https://www.scancircle.com/forum) +-- Forum: Reference (https://www.scancircle.com/forum/forumdisplay.php?fid=3) +--- Forum: Integration (https://www.scancircle.com/forum/forumdisplay.php?fid=24) +--- Thread: Autotask (/showthread.php?tid=191)

Autotask - arnoud - 30-09-2025 NOTE: No changes have been made yet in Autotask to support this integration and the integration has not been certified by Datto yet. By specifying the Autotask ticket number as a reference code for a scan, by default: The device specs are stored as a Configuration Item (asset), so that you don't need to enter this data manually; The Configuration Item is linked to the ticket; The scans are logged as internal ticket notes (so you can track the status of the device from check-in to check-out); Any changes to the device specs are also logged in the ticket note (so you can see what has been changed between scans) and optionally updated in the asset. You can now also automatically create a new ticket when performing a scan, so you don 't need to do this upfront (see 'Day-to-day use' step a). And if you don't want to use a ticket, then you can just specify a client/location/contact/contract/asset ID (see 'Day-to-day use' step g). Please watch the partner video first. @TODO Setup instructions: In your Autotask account, create a new API user: Admin > COMMONLY USED: Resources (Users) > Click the 'V' next to '+ New' > Select 'New API user': First Name: 'API' Last Name: 'ScanCircle' Email address: 'api@scancircle.com' Security Level: any security level (e.g. 'API User (system) Can't Read Costs') Primary Internal Location: any location (e.g. 'Headquarters') Click the Generate Key button (optionally change it to e.g. scancircle@...) and copy/remember this value Click the Generate Secret button and copy the generated value Under API Tracking Identifier, select 'Integration Vendor' and 'ScanCircle' If 'ScanCircle' is not yet available as 'Integration Vendor', select 'Custom (Internal Integration)', Internal Integration Name: 'ScanCircle' and copy the generated 'Tracking Identifier' (don't overwrite the Secret value in the clipboard) Click Save & Close In your ScanCircle partner environment, add/edit the Autotask integration: Login > Integrations tab > Integration = 'Autotask': User Name: the generated Username (Key) value Client Secret: the generated Password (Secret) value If you selected 'Custom (Internal Integration)', then add tracking= and the generated 'Tracking Identifier' to the More options setting Click Connect to connect to Autotask and retrieve the select list options and the default values Next, optionally change other fields and the Advanced settings, but the defaults usually suffice (for all fields, a description is shown at the righthand side) If you want to use the option for ScanCircle to automatically create a new ticket, then specify any text (e.g. '+T') in the 'Create ticket' field (as a reference code prefix, see 'Day-to-day use' step a). If this option is enabled, then extra fields will be shown needed/useful when creating a new ticket; Click Check to validate the configuration and generate/update the Shortcuts value (under 'Advanced settings'). If configuration entities are missing in Autotask, you will be prompted to have them created automatically. This will create a 'Configuration Item Category' with the name 'ScanCircle Device' (or the first name specified in the asset parameter), with the user defined fields Make & Model, OS, Motherboard, BIOS, Processor, Memory, Disk Info, Display Adapter(s), OS Installed, Product Keys, IP Address (fields that do not yet exist will be created) as well as the 'Configuration Item Type' and 'Product' with the same name Finally, click OK and don't forget to click Save Under the Scan widget tab: Specify the name of a URL parameter (e.g. 'ticketno') if you want to set the ticket number in a link, e.g. https://domain.com/scan?ticketno=xyz Specify an input field label (e.g. 'Ticket number') if you want the end-user to see/change/enter the ticket number Copy the generated HTML code or shortcode to your website Day-to-day use: If you don't already have a ticket, then run a scan with the reference code equal to the 'Create ticket' prefix setting, optionally followed by an existing 'Client ID'. This will create a new ticket in Autotask, log the scan in the ticket note and optionally create/update an asset (Configuration item) for the default or specified Client ID; Or create a new ticket in Autotask: fill in the required fields and click Save (NOT Save & Close). This will show the ticket number generated at the top (e.g. T20260612.0001); Then perform a ScanCircle scan on the device and enter the generated ticket number as reference code. This will store the device specs in a Configuration Item linked to the ticket and log the scan in the ticket; Now print/email a claim ticket for the customer if required and start fixing the device; Before you return the device, always perform another scan with the ticket number as reference code (logs the end state) and optionally print/email the ScanCircle Scan report (containing the before-and-after state) for the customer; You may allow the customer to periodically scan its device using the ticket number (tip: send them a link containing the ticket number after e.g. 3 months); If you don't want to use a ticket,  then you can just specify a client/location/contact/contract/asset ID preceded by the respective prefix setting (or matching the pattern for Client IDs). This will log the scan and any changes to the asset in the specified 'Asset note' and optionally update the asset fields; If you want to update the device specs manually, use the default 'Changes' setting, then update the specs based on the changes in the internal comments. Note: This plugin is as standard provided and maintained by ScanCircle. You do no need to install anything yourself. If you want to use this plugin, please subscribe to this discussion using the option in the lower left corner of this page so that you will be notified of any updates automatically.