CrewHu

Overview

CrewHu is an employee-recognition and CSAT platform for MSPs: customers rate tickets with 1-click surveys, and employees earn badges and redeem points for prizes.

The Bumblebee integration wraps CrewHu's read-only Open API. It reads CSAT survey responses (rating, comment, ticket, customer, and the employees the customer recognised), the employee directory, the badge catalog and badge awards, and the prize catalog and prize redemptions — all filterable by last-updated date range and paginated.

It never sends surveys or modifies your account.

Prerequisites & Setup

Before setting up the CrewHu integration, you need:

• A CrewHu account
• Admin access to Settings > Integrations to manage Open API access tokens

Generate an Open API access token

1. Sign in to your CrewHu account at app.crewhu.com
2. Go to Settings > Integrations
3. In the Open Api Access Tokens section, click + Add if no token exists yet
4. Click Copy Token

The token is sent as the X_CREWHU_APITOKEN header on every request. Treat it like a password — you can remove it in the same screen if it is ever exposed.

Configure in Bumblebee

1. Go to the Integrations page in Bumblebee
2. Select CrewHu
3. Paste your API Token into the credentials form
4. Save the configuration
5. Run a test request from the validation card (e.g. list surveys)

Using it for QBRs and recognition reporting

• Quarterly CSAT: ask for surveys in a date range — the agent passes updated_after/updated_before to list_surveys and aggregates ratings (5 positive, 0 neutral, -5 negative) by customer from customer_data.
• Recognition: badge awards reference badge and user IDs; the agent resolves them via list_badges and list_users.

Available Tools

All tools are read-only and return CrewHu's pagination envelope (results plus start/limit/size/total; limit default 20, max 100, page with step). Date filters use UTC ISO timestamps. Each also accepts a response_filter (JMESPath) to project large result sets.

CSAT surveys

• list_surveys — Answered customer surveys: rating, rating_label, comment, ticket_num, summary, customer_data, employees, survey_type_code, and timestamps. Filters: updated_after, updated_before, inactive.

Employees

• list_users — Employee directory: names, employee_id (from the ticket system), hiredate, location, department, position, and managed locations/departments.

Badges (recognition)

• list_badges — The badge catalog (recognition types).
• list_badge_history — Badge awards: badge, fromUser, toUsers, survey (when awarded from a customer survey), dateGiven, badgePoints, and cancellation fields.

Prizes (rewards)

• list_prizes — The prize catalog with points cost.
• list_prize_history — Prize redemptions: prize, user, date_redeem, points, quantity, status.