Takes Datto RMM Alert Webhooks and sends them to Halo PSA
I highly recommend you make a fork of this repository. When you click the deploy button it will ask you for the repository to deploy from, so you can easily paste in your own. You can still deploy from my respository, but I have built this function to be more of a starting point for you to extend it yourself to get the data you want to make resolving alerts quicker for your team.
Create a custom field on tickets in Halo with these details: Field Name: DattoAlertType Field Label: Datto RMM Alert Type Input Type: Anything Character Limit: Unlimited Once created make a note of the ID of the newly created field. It will appear at the end of the URL after id=
If you wish for the script to be able to display CPU and RAM usage for the device you will need to roll out a component to datto, configure it as a monitor on your devices and set it to run as often as you would like the data to update. This will then document RAM and CPU usage to the two custom fields you specify. (Default of 29 and 30) This can be downloaded from here https://github.com/lwhitelock/DattoRMM-Alert-HaloPSA/raw/main/Component/Document%20Current%20CPU%20and%20Memory%20use%20to%20UDF.cpt
This is your Datto API URL, it can be found when you obtain an API key in Datto RMM.
This is your Datto API key for the script.
This is your Datto API secret key for the script.
This is the UDF you set to store your CPU Usage.
This is the UDF you set to store your RAM Usage.
This is the number of columns you would like to render in the email body of details sections.
Create a Client ID and Secret API application in Halo. Assign the releveant permissions. This is the Client ID for that application.
This is the Client Secret for the application you created in Halo.
This is the URL for your Halo instance.
This is the ID of the status you would like tickets to be set to when created. You can get this by selecting the status in /config/tickets/status and looking at the ID in the URL.
This is the ID for the custom field you created in Halo.
This is the ID of the ticket type you would like tickets created as in Halo. You can get this from /config/tickets/tickettype by clicking on the type and looking in the URL
This is the status you would like to set tickets to if they reoccur.
To Deploy you can click the below button and then configure the settings as detailed above.
It can take about 30 minutes once the deployment completes for Azure to pickup all the permissions between the different components that were deployed. After 30 minutes I would recommend restarting your function app and checking in the function options that all the key vault references show green.
To use this script you need to edit your monitors to send to a webhook. First go to https://portal.azure.com/ and browse to your functiion app that was just deployed. Click on Functions on the left hand side and then on 'Receive-Alert'. At the top click on Get Function Url. This is the URL you will need to enter in Datto RMM as your webhook address.
Find the monitor you wish to edit in Datto RMM and set the URL as well as setting the body as below:
{
"troubleshootingNote": "Please turn the computer off an on again to fix the issue",
"docURL": "https://docs.yourdomain.com/alert-specific-kb-article",
"showDeviceDetails": true,
"showDeviceStatus": true,
"showAlertDetails": true,
"alertUID": "[alert_uid]",
"alertMessage": "[alert_message]",
"platform": "[platform]"
}
Save the montitor and then test it is working correctly before rolling it out for all your other monitors.
You can toggle individual details sections on and off for the monitor if they are not relevant and you can provide a link to your documentation as well as a quick troubleshooting message to help technicians with resolving issues faster.
If you have issues the easiest way to debug is to use VSCode with the Azure Functions extension. If you click on theAzure logo in the left and login, you can then find your function app from the list. Right click on the function and choose start streaming logs. Reset and alert so the webhook resends and look at any errors.