> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SmileBack API

> Read your SmileBack CSAT reviews, NPS responses and project surveys, and count your scores for any week or month

The common use is a weekly scheduled agent that counts last week's CSAT and NPS from SmileBack and writes them to your Strety Scorecard. Technicians can also ask an internal chat agent "what was our CSAT last month?" or "show me this week's negative reviews".

> [!NOTE]
>
> Automatically enabled when you configure SmileBack permissions in your agent workflow, or on a dashboard.

## What It Does

* Read CSAT reviews for any period: rating, comment, tags, the ticket with its board and technicians, the company and the contact
* Count CSAT %, Net CSAT and the response rate for the whole team, per technician or per customer
* List negative reviews with their comment and ticket, for a follow-up
* Read NPS responses per campaign and count your NPS
* Read project survey answers and score a project
* Put the week's scores on a Strety Scorecard Metric, with the [Strety API](https://docs.neoagent.io/agents/tools/management/strety-api.md)

## Permission Groups

| Group | Covers |
| - | - |
| CSAT Reviews | Rating, comment, tags, status, the ticket with its board and technicians, the company, the contact's name and email, and when it was viewed and rated; with the agents, boards, companies and contacts the reviews name. Read only |
| NPS | NPS campaigns and their responses: score, comment, campaign, and the contact's name, email, company and title. Read only |
| Project Surveys | Project surveys and their responses: each answer rated 1 to 5, the comment, the project and the contact. Read only |

## Access Profiles

SmileBack's API is read-only, so every profile reads all three groups and nothing asks a technician.

| Profile | What runs on its own | What asks a technician |
| - | - | - |
| **Read Only** | Every read | Nothing; SmileBack takes no write |
| **Helpdesk** | Every read | Nothing |
| **IT Admin** | Every read | Nothing |
| **Full Automation** | Every read | Nothing |

## Safety Controls

| Control | Behavior |
| - | - |
| **Read only** | Neo sends SmileBack only GET requests |
| **Rate limit** | Neo holds your tenant to SmileBack's limit of 30 requests a minute |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.