Customer Thermometer

Overview

Customer Thermometer is a 1-click customer satisfaction (CSAT) and NPS survey platform. Recipients click a colour-coded thermometer icon in an email and can leave a comment.

The Bumblebee integration is read-only: it surfaces an account's satisfaction reporting so the agent can assemble Quarterly Business Reviews (QBRs). It reads CSAT (Happiness Factor and Temperature Rating), NPS, response rate, response counts, and the individual responses and comments — all filterable by date range (for a quarter) and by survey campaign (blast).

It never sends surveys or modifies your account.

Prerequisites & Setup

Before setting up the Customer Thermometer integration, you need:

• A Customer Thermometer account
• Access to the Automations / API area to create an API key

Generate a Sub-API Key

1. Sign in to your Customer Thermometer account at app.customerthermometer.com
2. Open the API information page: app.customerthermometer.com/?template=endpoints
3. In the Sub API Key section, click Create API Key
4. Copy the newly generated key

Use the Sub-API key — it is scoped solely to the REST API. The Super API Key shown at the top of that page also works but has full access to your account, so the Sub-API key is the safer choice. You can Revoke the key on the same page if it is ever exposed.

Configure in Bumblebee

1. Go to the Integrations page in Bumblebee
2. Select Customer Thermometer
3. Paste your API Key (the Sub-API key) into the credentials form
4. Save the configuration
5. Run a test request from the validation card (e.g. list thermometers)

Using it for QBRs

The value metrics filter by date range and/or campaign, not by customer directly. To get a customer's quarterly CSAT:

• Pass that quarter's date range (from_date / to_date) — and, if the account uses one blast per customer, that customer's blast_id — to the value tools.
• Otherwise pull get_blast_results for the quarter and aggregate by the company field (or whichever custom_N field holds the customer) yourself.

Available Tools

All tools are read-only. Date parameters use YYYY-MM-DD; temperature_id is 1 = gold, 2 = green, 3 = yellow, 4 = red.

Discovery

• get_thermometers — List every thermometer (survey) with its ID and name.
• get_recipient_lists — List the recipient lists configured in the account.

CSAT & NPS metrics

• get_happiness_value — Happiness Factor, the headline CSAT percentage.
• get_temp_rating_value — Temperature Rating (weighted CSAT) percentage.
• get_nps_value — Net Promoter Score (-100 to 100).
• get_response_rate_value — Survey response rate percentage.
• get_num_responses_value — Count of responses, optionally by temperature_id.

Each accepts from_date, to_date, blast_id, and limit to scope the window.

Detailed responses & comments

• get_blast_results — Individual responses with attached recipient data (company, first_name, last_name, custom_1–custom_10), the rating (response), nps_rating, and comment.
• get_comments — The free-text comments left by respondents.

Both accept from_date, to_date, blast_id, temperature_id, and limit, plus a response_filter (JMESPath) to project large result sets.

Account

• get_send_quota — Remaining survey-sending credits.