Create a webhook rule

Create a rule defining the type of call you want to be sent to another destination. When the rule is triggered, the call data is sent out of Gong to the specified URL.

1. Click Company settings > Ecosystem > Automation Rules.

2. Click + Add Rule to display the create new rule page.

    

3. The default rule is that all calls trigger the action. Click to change the filter.

   The rule filter dialog is displayed. Select the filters and the calls that fit the selected criteria are displayed to the right of the filter pane.

   For more details on the filters, see Search for calls.

4. Select the Fire webhook action.

5. Enter the destination URL. The link should include an authentication method.

6. Select the authentication method.

   • URL includes key - include a secure random token within the URL

   • Signed JWT header - copy the public key and use it in the webhook to verify the digital signature of the sent data.

     Click Show public key to display and copy it.

7. Provide a rule name and description and then test the rule. One call that fits the criteria is provided for testing. Click Select a different call for something else. A list of eligible calls is displayed.

8. Now it's time to test the call.

   1. One call that fits the criteria is provided for testing. Click Select a different call for something else. A list of eligible calls is displayed. Click the desired call.

   2. Click Test now. You should see a success message in green on the top of the screen.

9. When you are satisfied that the rule works and that the type of call you need is triggered correctly, enable the rule.

   

For sample code to insert in the receiving destination when using a signed JWT header, see Prepare your receiving application to receive a webhook - JWT header. Also, see what Gong pushes to the Webhook when the rule has been triggered.

Note

When coding a system to accept Gong data, take into account that Gong may, without prior warning, add fields to the JSON output. It is recommended to future proof your code so that it disregards the JSON fields you don’t use.