GMail Sentiment Scanner

"AI-Powered Email Sentiment Analysis" by John Rippy | johnrippy.link

🏆 2025 Zapier Automation Hero of the Year — Project Phoenix: A 95-step AI sales pipeline cutting development time by 50%. Read more →

---

Analyze email sentiment trends for team and client communications. Get sentiment scores, response time patterns, and communication health insights from your Gmail inbox.

What This Actor Does

This actor connects to Gmail API to analyze your email communications and provides:

• Sentiment Analysis: Score each email thread from 0-100 (Very Negative to Very Positive)
• Client Segmentation: Break down sentiment by client/external domain
• Communication Health: Internal vs external sentiment comparison
• Trend Detection: Identify improving or declining client relationships
• Alerts: Early warning for sentiment drops or at-risk clients

Perfect For

• Account Managers: Monitor client relationship health
• Sales Teams: Track prospect communication sentiment
• Customer Success: Identify at-risk accounts early
• Team Leads: Monitor team communication patterns
• Freelancers: Keep pulse on client satisfaction

Features

• Demo Mode: Test the actor without Google credentials
• Smart Filtering: Exclude automated emails, newsletters, notifications
• Client Segmentation: Group analysis by external domain
• Sentiment Keywords: Detects positive, negative, and neutral patterns
• Privacy-First: Only analyzes metadata and snippets, not full email bodies

Input Examples

Demo Mode (No Credentials Required)

{
  "demoMode": true,
  "dateRange": "last_7_days",
  "segmentByClient": true
}

Real Mode with Google OAuth

{
  "demoMode": false,
  "accessToken": "ya29.your-access-token",
  "refreshToken": "your-refresh-token",
  "clientId": "your-client-id.apps.googleusercontent.com",
  "clientSecret": "your-client-secret",
  "dateRange": "last_30_days",
  "maxEmails": 200,
  "filterType": "external_only",
  "segmentByClient": true
}

Google OAuth Setup

To use this actor with real Gmail data:

1. Create Google Cloud Project

1. Go to Google Cloud Console
2. Create a new project or select existing
3. Enable the Gmail API

2. Configure OAuth Consent Screen

1. APIs & Services > OAuth consent screen
2. Choose "External" user type
3. Add required scopes: gmail.readonly
4. Add your email as a test user

3. Create OAuth Credentials

1. APIs & Services > Credentials
2. Create Credentials > OAuth client ID
3. Application type: Web application
4. Add authorized redirect URIs
5. Save Client ID and Client Secret

4. Get Access Token

Use Google's OAuth 2.0 Playground or your own OAuth flow to get tokens:

• Required scope: https://www.googleapis.com/auth/gmail.readonly

Output

Sentiment Overview

{
  "demoMode": false,
  "overview": {
    "emailsAnalyzed": 156,
    "overallSentiment": 62,
    "sentimentLabel": "Positive",
    "dateRange": "last_7_days",
    "internalSentiment": 68,
    "externalSentiment": 58
  },
  "trends": {
    "weekOverWeek": 5,
    "mostPositiveDay": "Tuesday",
    "mostNegativeDay": "Monday"
  }
}

Client Segments

{
  "clientSegments": [
    {
      "domain": "acmecorp.com",
      "emailCount": 12,
      "avgSentiment": 75,
      "sentimentTrend": "improving",
      "topPositiveSubjects": ["Thank you for the quick turnaround!"],
      "topNegativeSubjects": []
    },
    {
      "domain": "troubledclient.com",
      "emailCount": 8,
      "avgSentiment": 32,
      "sentimentTrend": "declining",
      "topPositiveSubjects": [],
      "topNegativeSubjects": ["Urgent: Issue with the latest update"]
    }
  ]
}

Alerts & Recommendations

{
  "alerts": [
    {
      "type": "client_concern",
      "message": "2 client(s) showing declining sentiment",
      "severity": "medium"
    }
  ],
  "recommendations": [
    "Schedule check-in calls with: troubledclient.com, demandingco.com",
    "Client communication sentiment is lower than internal - consider proactive outreach"
  ]
}

Sentiment Scoring

Score	Label	Meaning
75-100	Very Positive	Appreciation, praise, excitement
60-74	Positive	Generally favorable tone
45-59	Neutral	Transactional, informational
30-44	Negative	Concerns, issues, problems
0-29	Very Negative	Complaints, urgent issues, frustration

Detection Keywords

Positive signals: thank, appreciate, great, excellent, wonderful, love, excited, well done

Negative signals: sorry, unfortunately, issue, problem, disappointed, frustrated, urgent, mistake

Neutral dampeners: fyi, update, reminder, following up, attached

Limitations (Apify Version)

• Maximum 500 emails per run
• Point-in-time analysis (no historical comparison)
• Manual OAuth token management
• Single mailbox only

Enterprise Version

For continuous monitoring, team-wide insights, and automation:

Workspace Intelligence by LocalHowl

• Real-time OAuth connection (no token management)
• Continuous monitoring & Slack/Teams alerts
• Historical trend analysis
• Team-wide rollups & dashboards
• Client health scoring with CRM integration
• SSO/SAML authentication

Privacy & Security

• Uses Gmail API with gmail.readonly scope
• Only analyzes subject lines and snippets
• No full email body content stored
• All analysis aggregated, not individual tracking
• OAuth tokens handled securely

Related Actors

• Workspace Sentiment Analyzer: Full Google Workspace analysis
• Teams Meeting Cost Tracker: Microsoft Teams calendar analysis
• Meeting Culture Score Checker: Public meeting culture analysis

Support

• Documentation: https://meeting.localhowl.com/docs
• Email: support@localhowl.com
• Issues: Report bugs or request features

---

Author

Built by John Rippy | johnrippy.link

2025 Zapier Automation Hero of the Year — Project Phoenix: A 95-step AI sales pipeline cutting development time by 50%. Read more

Part of the Workspace Intelligence suite by LocalHowl