Webhooks

SatisMeter integrates with many tools, either directly or through our Segment integration.

If you use a tool we don't support, or an in-house tool, webhooks can help. A webhook notifies your service every time a user submits a new response.

Configure webhooks in the Integrations section of your SatisMeter settings. Enter the URL of your web service, and we send the data to that URL.

Example

Here's an example of the data we send to the webhook:

{
  "response": {
    "rating": 9,
    "feedback": "You are awesome!",
    "answers": [
      {
        "id": "00000000000000",
        "label": "How would you rate the support?",
        "value": 5
      },
      {
        "id": "00000000000000",
        "label": "Select your favourite feature from the list",
        "value": "Dashboard filters"
      },
      {
        "id": "00000000000000",
        "label": "Do you have any comments for us?",
        "value": "You are awesome!"
      }
    ],
    "completed": true,
    "created": "2015-07-31T19:48:07.648Z",
    "method": "In-app",
    "referrer": "https://app.satismeter.com/sample",
    "project": "00000000000000",
    "ip": "88.100.78.186",
    "location": {
      "country": "US",
      "city": "Springfield",
      "long": "Springfield, United States",
      "short": "Springfield"
    },
    "user": {
      "name": "Homer Simpson",
      "email": "homer@simpson.com",
      "userId": "1234",
      "traits": {}
    },
    "category": "promoter",
    "id": "00000000000000"
  },
  "event": "completed"
}

The response.answers array contains the answers to the survey's follow-up questions:

• id: A unique identifier for the question.
• label: The exact question text shown to the user.
• value: The answer to the question. It's a number for 1 – 5 rating questions, or a string for single-choice and free-text questions.

You can configure a webhook to trigger in these scenarios:

• When a user answers all questions ("event": "completed").
• When a user closes the survey ("event": "dismissed").