Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt

Use this file to discover all available pages before exploring further.

Paid Feature — AskNicely is available on Chartcastr paid plans. See pricing.

Overview

Use AskNicely as a data source for Chartcastr. Connect your AskNicely account to turn your NPS programme into scheduled charts: current score, NPS trend, response volume, and survey funnel metrics. Chartcastr connects with read-only access to the AskNicely REST API using your account subdomain and an API key.

Setup

1

Find your subdomain

Your AskNicely account lives at a subdomain like https://acme.asknice.ly. The subdomain is the part before .asknice.ly.
2

Generate an API key

In AskNicely, go to Settings → API Keys and generate a new key. Chartcastr passes this via the X-apikey request header on every call.
3

Connect in Chartcastr

In Chartcastr, create a new source and choose AskNicely. Enter your subdomain and the API key. Chartcastr will validate the connection against /api/v1/getnps/30 before saving.
4

Pick a metric

Choose the AskNicely metric you want to track. Each metric becomes its own source you can route to Slack or email on any schedule.

Available Metrics

NPS

Current 30-day NPS score, NPS trend, and promoter / passive / detractor breakdown.

Responses

Total responses, score-category bucketing, and recent score history.

Stats funnel

Daily sent / delivered / opened / responded, response rate, and comment rate.

View all available charts

See the full list of AskNicely metrics with chart types and descriptions.

How the connection works

  • Auth: API key + subdomain. The API key is encrypted at rest using AES-256-GCM and is never sent to the browser after setup.
  • Base URL: https://{subdomain}.asknice.ly
  • Endpoints used: /api/v1/getnps/{days}, /api/v1/responses/..., /api/v1/stats
  • Redirects: Chartcastr follows AskNicely’s S3 redirect for large response payloads automatically.

Disconnecting

Open Admin → Settings → Sources → AskNicely and click Disconnect. This archives all AskNicely sources for the org and revokes Chartcastr’s stored credentials.