Help Scout Integration / Documentation

Help Scout Integration Documentation

Technical documentation covering data access, security practices, and setup instructions for Jetson's Help Scout integration.

Overview

Jetson integrates with Help Scout to analyze your customer support conversations and surface actionable product insights. By connecting your Help Scout account, Jetson can:

  • Classify conversations as bug reports, feature requests, documentation needs, or general questions
  • Detect patterns across conversations to identify trending issues
  • Create bug reports and feature requests that link directly back to the original conversations
  • Sync in real-time so new messages are analyzed within minutes

How It Works

Help Scout
OAuth + Webhooks
Jetson
Analysis
Insights

Setup Guide

1

Connect via OAuth

Click the "Connect Help Scout" button in Jetson. You'll be redirected to Help Scout's authorization page where you can review the permissions and approve the connection.

  • Your Help Scout credentials never leave Help Scout
  • Jetson receives a secure OAuth token with limited permissions
  • You can revoke access at any time from Help Scout settings
2

Select Mailboxes

After connecting, choose which Help Scout mailboxes you want Jetson to analyze. You can select one or multiple mailboxes.

3

Configure Documentation (Optional)

If you use Help Scout Docs, you can connect it to improve classification accuracy. Jetson will use your documentation to better understand your product areas.

  1. Go to your Help Scout profile and navigate to Authentication → API Keys
  2. Create a new API key with Docs permissions
  3. Paste the key in Jetson and map your mailboxes to documentation collections
4

Initial Scan

Jetson imports your recent conversations and begins analysis. You'll see bug reports and feature requests appear in your dashboard as conversations are classified. A webhook is automatically configured for real-time sync of new messages.

Data Access & Usage

Data We Access

  • User info: ID, email, name (for account linking)
  • Mailboxes: ID, name, email address
  • Conversations: ID, subject, status, timestamps
  • Threads: Message content, sender info, timestamps
  • Docs (optional): Collections and articles for context

Data We Don't Access

  • Payment or billing information
  • Help Scout account settings or admin functions
  • Team member passwords or credentials
  • Reports or analytics data
  • Saved replies or workflows

How Your Data Is Used

Classification Jetson analyzes message content to categorize as bug, feature, question, etc.
Pattern Detection Multiple messages about the same issue are grouped together.
Bug & Feature Tracking Bug reports and feature requests are created with links to original conversations.

Your data is never: Shared with third parties, sold, used for advertising, or used to train models.

Security & Privacy

OAuth Security

  • State parameter: CSRF protection on all OAuth flows using cryptographically random state tokens
  • Encrypted storage: OAuth tokens are encrypted at rest in our database
  • Automatic refresh: Tokens are refreshed before expiration to maintain uninterrupted service
  • Limited scope: We only request the minimum permissions needed for the integration

Webhook Security

  • HMAC-SHA1 signatures: Every webhook request is signed and verified before processing
  • Unique secrets: Each integration has its own webhook secret for signature verification
  • Deduplication: Message IDs are tracked to prevent duplicate processing

Data Protection

  • Encryption in transit: All API communications use TLS 1.2+
  • Encryption at rest: Database encryption for sensitive data
  • Organization isolation: Data is strictly isolated between organizations
  • Role-based access: Team members see only what their role permits

Real-Time Sync

Jetson uses Help Scout webhooks to receive real-time notifications when new messages arrive. This ensures your dashboard stays current without manual intervention.

Webhook Events Subscribed

convo.customer.reply.created

Triggered when a customer sends a new message

convo.agent.reply.created

Triggered when a support agent sends a reply

Processing Flow

  1. 1 Webhook received with HMAC-SHA1 signature
  2. 2 Signature verified against stored webhook secret
  3. 3 Message ID checked for deduplication
  4. 4 Message processed through classification pipeline
  5. 5 Bug reports and feature requests updated or created as needed

Revoking Access

From Jetson

  1. 1 Go to Settings → Integrations
  2. 2 Find Help Scout and click "Disconnect"
  3. 3 Confirm the disconnection

From Help Scout

  1. 1 Go to Help Scout → Your Profile
  2. 2 Navigate to My Apps
  3. 3 Find Jetson and revoke access

What happens to your data?

When you disconnect, Jetson stops syncing new conversations. Previously imported data remains in your Jetson account until you delete your account. To permanently delete all data, contact support or delete your Jetson account.

Frequently Asked Questions

Need Help?

If you have questions about the Help Scout integration or need assistance, we're here to help.