Freshdesk Integration | Cloudmon

Freshdesk

Third Party Integration

Freshdesk

Automatically create tickets in Freshdesk when Cloudmon alarms fire, and optionally resolve them when the alarm clears, so your support team can track and resolve incidents.

Overview

The Freshdesk integration allows Cloudmon to raise tickets in your Freshdesk account when an alarm fires. If automatic resolution is enabled, Cloudmon also resolves the ticket when the alarm clears, keeping Freshdesk in step with your monitoring state without manual intervention.

Before You Begin: Collect Details from Freshdesk

Collect the following details in Freshdesk before you configure the integration in Cloudmon.

FieldDescription
DomainYour Freshdesk host from the browser address bar, for example https://acme.freshdesk.com.
API KeyFound in your Freshdesk Profile Settings. See How To Find Your API Key.
Requester EmailAn existing Freshdesk contact, or leave it for Freshdesk to create. See Manage Customer Data in Freshdesk.
Agent permissionThe agent behind the API key needs a role that can create and edit tickets. See Manage agent roles and permissions in Freshdesk.
Ticket TagsFree text. Any tag entered in Cloudmon is created in Freshdesk on first use. See Using Tags in Freshdesk.

The API key is stored encrypted and is never shown again after saving. Use Test Connection to verify the domain and key before saving.

Step 1: Configure in Cloudmon

  1. Navigate to Settings → General Settings → Integrations.
  2. Locate the Freshdesk widget and click the + Account button.
  3. In the Freshdesk Account section, fill in the fields as described in the first table.
  4. Click Test Connection to verify the domain and API key.
  5. In the Ticket Settings section, configure how alarms become tickets, as described in the second table.
  6. Click Save.

Freshdesk Account

FieldDescription
Integration NameA display name to identify this integration in Cloudmon, such as "IT Helpdesk".
DomainThe full Freshdesk host, for example acme.freshdesk.com, or just the sub-domain acme. When only the sub-domain is entered, .freshdesk.com is added for you.
API KeyThe API key of the Freshdesk agent that Cloudmon uses to create tickets.
Requester EmailThe email address recorded as the requester on tickets created by Cloudmon, for example monitoring@yourcompany.com.

Ticket Settings

FieldDescription
Ticket SubjectThe text used as the ticket subject. The default is $device_name is $severity - $title. Type $ to pick a replaceable tag from the list, and use the reset icon beside the field to restore the default.
Create Tickets For SeveritiesSelect the alarm severities that create a ticket: Down, Critical, Trouble and Attention. The matching priority is shown beside each severity: Down is Urgent, Critical is High, Trouble is Medium and Attention is Low. At least one must be selected.
Resolve Ticket Automatically When Alarm ClearsEnabled by default. When enabled, Cloudmon resolves the ticket when the alarm clears. When disabled, the ticket must be resolved manually.
Ticket TagsOptional. Type a tag and press Enter to add it. Add as many as you need.

The Reset button restores the form to its default values, and Close exits without saving.

Step 2: Enable in Alarm Rules

  1. Navigate to Settings → Configurations → Alarm Rules.
  2. Click the Add button to create a new alarm rule, or open an existing one.
  3. Add a trigger and configure the alarm conditions.
  4. In the THEN section, enable Third Party Services and select the configured Freshdesk integration from the dropdown.
  5. Click Save.

When this alarm fires, Cloudmon creates a ticket in Freshdesk automatically, for the severities selected in the integration.