Introduction
PMG is designed to be a powerful and flexible mail gateway that can be easily integrated into any email infrastructure. It is compatible with a wide range of email clients and servers, and can be used in both inbound and outbound email scenarios. PMG supports a variety of deployment scenarios, from small businesses to large enterprises, and can be customized to meet specific requirements.
Install the integration
- From All Clients, select a client.
- Go to Setup > Account.
- Select the Integrations and Apps tab.
- The Installed Integrations page, where all the installed applications are displayed. Note: If there are no installed applications, it will navigate to the ADD APP page.
- Click + ADD on the Installed Integrations page. The Available Integrations and Apps page displays all the available applications along with the newly created application with the version.
Note: You can even search for the application using the search option available. Also yu can use the All Categories option to search. - Click ADD in the PMG application and click Install.
Configure the integration
Configure the following:
- Inbound
- Outbound
- Monitoring of Integration
- Audit Logs
Inbound (PMG to OpsRamp)
- In Authentication, configure the authentication to call Freshservice APIs.
- Select OAUTH2 as Authentication Type.
- Click Save.
Note: Copy the Tenant Id, Key, and Secret.

- Configure Map Attributes to map PMG attributes with OpsRamp entity attributes.
- Select OpsRamp Entity from the drop-down menu.
- Click OpsRamp Property against the respective attribute, enter the mapping details.

- Configure ITSM Properties to define properties required to call PMG API using events. Enter the values for Properties.
- Click Save.

Outbound (From OpsRamp to PMG)
- In Integration Basic Configuration, configure basic notification details to trigger integration events.
- Notification Type: SOAP API or REST API.
Note: When you select SOAP API, users will only be able to choose NONE or BASIC under Authentication Type. - Base URI:
https://{subdomain}/api/v2/tenants/{tenantId}
- Authentication Type: Select any of the below authentication type:
Note: The below options are only be available when you select REST API as Notification Type.
- Notification Type: SOAP API or REST API.
Authentication Type | Description |
---|---|
NONE | No authentication is required. |
BASIC | Basic authentication such as User Name and Password is required. |
OAUTH2 | Provide the below information:
|
JWT | Provide the below information:
![]() |
- In Map Attributes, map OpsRamp entity attributes with PMG attributes:
- Click Map against the attribute. The Create Integration Mapping window is displayed.
- Enter the required details.

- In Integration Events, add the following details:
- Click +Add. The Add Integration Event page is displayed.
- Enter a name for the integration event.
Note: An action performed on an entity is defined as an event. When an event is triggered, notifications are sent to the respective users. - Select Service Desk or Resource from drop-down, select entity type, and select the action.
- Select Parent Configuration to assign the configured basic integration details.
- Enter the Endpoint URL and select the Web Method from the drop-down.
- Enter the Headers name and value, payload, and click Save.

Notes:
- To add more tokens to the payload, click the token in the Place Holders list.
- To parse properties returned in the response with OpsRamp, select OpsRamp property from the drop-down and enter the parsing value.
- A custom field that is already configured as a response payload attribute for a given integration is not available for configuration in any other integrations. You need to remove the existing mapping from the integration to make the custom field available to map on the response payload of any other integration.
Integration response mapping configuration:
Response mapping configuration is mainly based on the response payload that is received in third party payload;
below are a few examples for response mapping configuration -
- sample response payload to mapping the id in response mapping:
{
"id":"INC0001",
"type":"incident",
"tool":"servicedesk"
}
external ticket id = $id
We need to append **$** to the value
2. sample response payload to mapping the id in response mapping:
{
"result":{
"id":"INC0001",
"type":"incident",
"tool":"servicedesk"
}
}
external ticket id = $result.id 3. Sample response payload to mapping the id in response mapping:
{
"result":[
{
"ticketDetails":{
"id":"INC0001",
"type":"incident",
"tool":"servicedesk"
},
"Description":{
"display_value":"testing description",
"value":"validating"
}
}
]
}
external ticket id = $result[0].ticketDetails.id 4. sample response payload to mapping the Incident Number in response mapping:
{
"result": {
"Incident Number": "INC0001",
"type": "Incident"
}
}
external ticket id = $result[‘Incident Number’]Verify Integration: Enter sample values to validate if the integration is successful.
- Select an event from the drop-down, enter the XML payload, and click Verify. A 200-OK success response is generated if the integration is successful.
Integration Failures: In case of a failure in integration, a message is sent to the respective user.
- Select notification type Email, enter the email address, and click Save.

Monitoring of Integration
- Click + Assign Templates.
- The Assign Template page appears.
- Select a template and click Assign Template.

Audit Logs
In the Audit logs section, enter the required details and click Apply.
