Merge supports third-party webhooks for Freshdesk! This means Freshdesk linked accounts are able to receive Merge-normalized Tickets, whenever a Freshdesk ticket is updated or comments are added on any tickets — in real-time!
Steps for your end user to set up webhook in Freshdesk
In your Freshdesk account, navigate to Admin (a gear icon on the left navigation pane), then navigate to Automation. Finally, navigate to Ticket Updates.
Click New Rule to create a new rule. We will create a webhook that captures any updates to tickets & comments.
Enter any rule name.
For “When an action performed by…”, set Agent or requester.
For “Involves any of these events:”, set Ticket is + Updated.
For “Perform these actions”,
Set Trigger Webhook
Set POST as the request type
Set the Merge webhook listener as the URL.
Set Add custom headers, and add the following. Replace “mysecretkey” with your own key. This is the same key that would be used to authenticate any received webhooks once you activate the rule. Make sure to keep the name “custom-webhook-key”.
{ "custom-webhook-key": "mysecretkey" }Set JSON as Encoding method.
Set Advanced for Content. Copy & paste exactly the text below in the text box. This is the response payload of the webhook when any tickets are updated or any comments are added. This allows us to properly process the real-time updates.
{ "webhook_event": "ticket_update", "ticket_id": {{ticket.id}} }
Click Preview & Save, then click Save. This saves & activates your webhook!
Add the secret key you used to the Signature Key of the Merge webhook.
To our customers: To set up the Signature Key and Webhook Listener URL on Merge’s side, follow the instructions here! You can also use our /webhook-receiver endpoint to set up Merge’s Webhook Listener URL.
The event for this webhook is “ticket_update”.