Entrar

NPS / CSAT por loja — satisfação e avaliações do cliente

GET https://{organization}.myguper.com/api/register/report/feedbackNps

Relatório de satisfação do cliente consolidado — NPS, CSAT, as notas e avaliações que os clientes deixam — a resposta para "qual o nosso NPS", "satisfação por loja", "como os clientes estão nos avaliando", "quais lojas pontuam melhor", numa única chamada. Sem precisar paginar as avaliações (feedback) loja a loja. (Para as respostas uma a uma, use a listagem de feedback reviews.)

Devolve o total geral e a quebra por loja, com responses, avgRating, e quantas avaliações vieram sem vendedor (withoutSalesperson, tipicamente ecommerce).

O resto depende do type:

  • type=nps (escala 0-10): promoters (9-10), passives (7-8), detractors (0-6) e o nps = (promotores − detratores) / respostas × 100.
  • type=csat (escala 1-5): satisfied (4-5), neutral (3), unsatisfied (1-2) e satisfactionRate = satisfeitos / respostas (razão, 0.967 = 96,7%). Os campos de NPS não saem para CSAT — nota 1-5 nunca é "detrator" na faixa 0-10, então um NPS ali não faz sentido.

groupBy quebra por store (default), day ou month (combinável com store, ex. month,store) — sai em rows, com o dia/mês no fuso da org. Campanha e canal não saem daqui (o feedback não guarda campanha, só orderId): para "NPS por campanha", passe os pedidos da campanha em order[].

client[] / order[] restringem a um coorte — é como você cruza satisfação com comportamento: pegue o coorte em outro serviço (ex.: quem resgatou cashback, no loyalty) e passe aqui para ler o NPS/CSAT daquele grupo, comparando com o geral.

Try-it values populated from environment ACME (Demo)


Autenticação

Token

Send your user token in the x-guper-authorization header.

Cabeçalhos

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Parâmetros de query

Name Type Description
days integer Window: the last N days (1-730). Default 90. Ignored when dateStart/dateEnd are given.
dateStart string Start date (YYYY-MM-DD). Use together with dateEnd for an explicit window.
dateEnd string End date (YYYY-MM-DD), inclusive.
type string Which survey to report. Default `nps`. `nps` returns the 0-10 bucket (`promoters`/`passives`/`detractors`/`nps`); `csat` returns the 1-5 one (`satisfied`/`neutral`/`unsatisfied`/`satisfactionRate`). `avgRating` and `responses` come with both.
store integer Restrict to a single store id.
groupBy string Break the numbers down by `store` (default), `day` or `month`, or a comma list combining `store` with `day`/`month` (e.g. `month,store`). `day` and `month` cannot be combined. Each breakdown comes under `rows`; `total` is always the overall. When `groupBy=store`, `rows` is also aliased as `byStore` for compatibility. The day/month is cut in the **org timezone** (feedback timestamps are stored in BRT and converted). **Campaign and channel are not here** — feedback carries no campaign, only `orderId`; for "NPS by campaign" pass the campaign's orders in `order[]`.
client[] array Restrict to a cohort of client (person) ids. This is how you cross satisfaction with behavior: get the cohort elsewhere (e.g. the clients who redeemed cashback, from loyalty) and pass it here to read **that cohort's NPS/CSAT** — then compare with the overall. Comma list or array; up to 5000.
order[] array Restrict to a cohort of order ids — e.g. the orders attributed to a campaign (from the order side), to read the NPS/CSAT of that campaign's buyers. Comma list or array; up to 5000.

Respostas

{
  "meta": { "type": "nps", "period": { "start": "2026-06-11", "end": "2026-09-09" }, "store": null },
  "total": {
    "stores": 58, "responses": 3753,
    "promoters": 3637, "passives": 75, "detractors": 41,
    "nps": 95.8, "avgRating": 9.82,
    "withoutSalesperson": 1136, "withoutSalespersonPct": 0.3027
  },
  "byStore": [
    { "storeId": 40,  "store": "ECOMMERCE",            "responses": 478, "promoters": 459, "passives": 7, "detractors": 12, "nps": 93.5, "avgRating": 9.73, "withoutSalesperson": 478, "withoutSalespersonPct": 1 },
    { "storeId": 155, "store": "CC MERIDA ALTABRISA",  "responses": 195, "promoters": 191, "passives": 4, "detractors": 0,  "nps": 97.9, "avgRating": 9.90, "withoutSalesperson": 34,  "withoutSalespersonPct": 0.1744 },
    { "storeId": 138, "store": "CC MERIDA GALERIAS",   "responses": 162, "promoters": 161, "passives": 1, "detractors": 0,  "nps": 99.4, "avgRating": 9.90, "withoutSalesperson": 25,  "withoutSalespersonPct": 0.1543 }
  ]
}

Relacionados

Copied to clipboard