Developer Platform
  • Home
  • Getting Started
    • General Information
    • Features Overview
    • Security
  • APPs
    • Public Apps
      • Shopify
      • Salesforce
      • Zendesk
      • Google Analytics
    • Build your App
      • Getting started
      • My Apps
      • App information
      • App Parameters
      • App Plugins
      • Add Webhooks
      • Submit your Apps
      • App security
      • Developer Policy
  • Use Cases
    • Copilots
      • Product Catalog sync through API
      • FAQ sync through API
    • Visitor experience
      • Integrating custom buttons into your site
      • Check availability before escalating to iAdvize
      • Authenticated Messaging
        • Introduction
        • Web client-side implementation
          • Authenticated Messaging overview
          • Brief timeline of the integration process
          • How to enable authenticated mode in the administration portal?
          • How to implement the customer authentication backend (token provider)?
          • How to authenticate with iAdvize in client's website?
          • How to deal with activation success or failure?
          • How to logout?
          • Compatibility with Mobile SDK
          • FAQ
        • Web backend implementation
          • Important information and recommendations
          • Signature and Encryption Detailed Process
          • Technical backend implementation
          • FAQ
      • Cross-domain Conversation Continuity
      • Customize replies with Markdown
    • Agent workspace
      • Custom App example and step-by-step tutorial
        • Get Started
        • Work with the Desk
        • Intent / Trigger
        • JWT
        • References
    • Administration
      • Users
        • SAML SSO Authentication - Implementation Guide
        • Create, update and delete users via API
        • Manage the availability of your users with the iAdvize API
        • Integrate the iAdvize conversation panel into an existing tool
      • Anonymize a conversation or visitor data
    • Data & Analytics
      • Extract conversation transcript
      • Retrieve metrics and KPIs
        • Pre-aggregated indicators
        • Understand transaction data
        • Understand conversation data 1/2
        • Understand conversation data 2/2
        • Understand satisfaction data
        • Understand production indicators
  • Technologies
    • GraphQL API
      • Terminology
      • Reference
      • Authentication
      • Schema lifecycle
      • Error Management
      • Pagination
    • REST API (deprecated)
      • Statistic (deprecated)
      • Group (deprecated)
      • Call meeting (deprecated)
      • Operator (deprecated)
      • Skill (deprecated)
      • Transaction (deprecated)
      • Visitor (deprecated)
    • Webhooks
      • Reference
      • Guides
    • Desk events
      • Reference
    • Web & Mobile SDK
      • Javascript Web SDK
        • Reference
      • Javascript Callbacks
        • Reference
        • Guides
      • Mobile SDK
        • Gaperon (latest)
        • Fourme
        • Epoisses
        • Dauphin
        • 🤝Support Policy
        • 🤔Frequently Asked Questions
    • Custom App
    • External Bot
      • Implementation
        • Configuration flow
        • Conversation flow
        • Conversation objects
      • Configuration
      • FAQ
      • Best practices
Powered by GitBook
On this page
  • What you can retrieve
  • 1. CSAT – Customer satisfaction score
  • 2. NPS – Net Promoter Score
  • 3. Free Comment – Open-Ended Feedback
  • What the API response includes
  • Ready to use it?

Was this helpful?

  1. Use Cases
  2. Data & Analytics
  3. Retrieve metrics and KPIs

Understand satisfaction data

Understanding how your customers feel after a conversation is key to improving service quality, coaching your team, and identifying friction points. The satisfactionSurveyResponses query in the iAdvize GraphQL API allows you to programmatically retrieve all responses to satisfaction surveys submitted by your customers including structured scores and open feedback.

What you can retrieve

Each response to a satisfaction survey is composed of up to three types of data:

1. CSAT – Customer satisfaction score

The CSAT (Customer satisfaction) score is a numerical rating that indicates how satisfied the visitor was after their conversation.

  • Scoring scale: 1 (very unsatisfied) to 5 (very satisfied)

📌 Available for channels:

  • Chat (both agent and bot)

  • Facebook Messenger

  • Apple Messages for Business

  • WhatsApp

2. NPS – Net Promoter Score

The NPS (Net Promoter Score) is a measure of customer loyalty and satisfaction based on how likely a customer is to recommend your service.

  • Scoring scale: 0 (Not at all likely) to 10 (Extremely likely)

  • Interpretation:

    • 0–6: Detractors

    • 7–8: Passives

    • 9–10: Promoters

📌 Available for channels:

  • Chat (both agent and bot)

3. Free Comment – Open-Ended Feedback

This is an optional open-text field where visitors can share qualitative feedback in their own words.

  • Allows for:

    • Identifying praise or complaints

    • Spotting UX issues

    • Enriching coaching feedback loops

📌 Available for channels:

  • Chat (both agent and bot)

What the API response includes

When you query satisfactionSurveyResponses, you can access:

  • Conversation ID

  • Survey type (CSAT or NPS)

  • Score value

  • Comment (if left by the visitor)

  • Timestamps (response date)

  • Agents who participated in the conversation

The API supports filtering and pagination, allowing you to process large volumes of feedback systematically.

Ready to use it?

PreviousUnderstand conversation data 2/2NextUnderstand production indicators

Last updated 3 days ago

Was this helpful?

You can explore the satisfactionSurveyResponses schema and test live queries in the .

iAdvize GraphQL API Explorer