Help Scout Integration Documentation
Technical documentation covering data access, security practices, and setup instructions for Jetson's Help Scout integration.
On this page
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
Setup Guide
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
Select Mailboxes
After connecting, choose which Help Scout mailboxes you want Jetson to analyze. You can select one or multiple mailboxes.
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.
- Go to your Help Scout profile and navigate to Authentication → API Keys
- Create a new API key with Docs permissions
- Paste the key in Jetson and map your mailboxes to documentation collections
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
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 Webhook received with HMAC-SHA1 signature
- 2 Signature verified against stored webhook secret
- 3 Message ID checked for deduplication
- 4 Message processed through classification pipeline
- 5 Bug reports and feature requests updated or created as needed
Revoking Access
From Jetson
- 1 Go to Settings → Integrations
- 2 Find Help Scout and click "Disconnect"
- 3 Confirm the disconnection
From Help Scout
- 1 Go to Help Scout → Your Profile
- 2 Navigate to My Apps
- 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.