Outgoing Webhooks allows you to set up a Webhook or API call to a system other than CustomerGauge whenever a survey complete happens. This is ideal if a portion of your organisation closes the loop in another system, or if you'd like your survey feedback to flow back into a data warehouse.


Disclaimer: Outgoing Webhooks require technical expertise to be set up and maintained.


Requirements

To start setting up an Outgoing Webhook you'll need:

  • Admin access to CustomerGauge;
  • Sufficient access in the other system to obtain your authentication details;
  • Technical experience on how to set up an API Call.



Which systems can be connected to?

Our Outgoing Webhooks are designed to easily connect to most API Suites. Some of the systems you can connect to are:

  • Any system that allows authentication through OAuth 2 "Client Credentials" or "Resource Owner Password Credentials" grant types
  • Any system that allows authentication through URL parameters, or headers (such as Basic Authentication)
  • Microsoft Dynamics
  • SugarCRM
  • Freshdesk
  • Zendesk
  • ServiceNow


See our Recipes Overview to see some of the common implementations!



How to set up

  1. In the menu, navigate to Data → Integrations, and then on the Integrations page click the Webhooks tab.
  2. Click on New Webhook, followed by "Outgoing". This will take you to the New Outgoing Webhook form.
  3. Set up the API configuration as needed.
    1. Method: Choose POST to call a POST API (typically to create a new record) or PUT (typically to interact with an existing record) to call a PUT API.
    2. API URL: Add in the full API URL of the API you'd like to call.
    3. Secret: You can use this field to add a secret that can be used to sign the request. We recommend using a unique secret for every Webhook you set up.
    4. Custom Headers:You can set up a multitude of Custom Headers. Add as many as you need for your API Call.
      1. Header name: Add the header name that you'd like to add.
      2. Value: Add the appropriate value for the header you'd like to add.
      3. Secure: Check this box if you'd like to obfuscate the value. This is useful if you'd rather not expose sensitive information, such as API Keys.
      4. Add: Clicking this button will add the custom header to the list of custom headers. You'd still need to press the Save button in the Details step in order to save the Custom Header.
    5. Request Body: Add the Body of the API Request. You can add this in JSON, XML, or a raw body - depending on what your API needs.
    6. Next: Press the Next button when you're done setting up the API. It's in the next step where you can save your Webhook.
  4. Finish up the Webhook
    1. Name: Give a descriptive name to your Webhook.
    2. Enable/Disable: Choose whether you'd like your Webhook to go live immediately or not.
    3. Save: Press the Save button to save the whole setup.



Available Data Fields

The following list of fields can be used to send data to your external system by using the Merge Tag value in your Body.

Merge Tags are dynamic placeholders of data that will be filled in with the value of the Survey Response that triggers the Outgoing Webhook. Add the value in the "Merge Tag" column in the appropriate place in the Body to pass the value.


Merge TagCustomerGauge Field
{{ event.account_display }}Account Name
{{ event.division_display }}Division
{{ event.date_order_display }}Order Date
{{ event.date_email_sent_display }}Survey Sent Date
{{ event.date_form_completed_display }}Survey Completed Date
{{ event.number_customergauge_display }}CG-ID
{{ event.nps_display }}NPS Score
{{ event.touchpoint_display }}Touchpoint
{{ event.country_display }}Country
{{ event.job_level_display }}Job Level
{{ event.language_display }}Language
{{ event.email_display }}Email
{{ event.phone_display }}Telephone Number
{{ event.job_title_display }}Job Title
{{ event.segment_a_display }} through {{ event.segment_z_display }}Segment A through Z