Social Media Performance Reporter

What This Agent Does

This Social Media Performance Agent automatically collects data from your Twitter and Facebook accounts, analyzes engagement metrics, and generates a comprehensive HTML performance report delivered directly to your marketing team's inbox. In just minutes, you'll have professional insights that would typically take hours to compile manually.

By automating your social media analytics workflow, this agent saves your team 4-6 hours per week on data collection and report generation. Instead of manually downloading metrics from multiple platforms, copying data into spreadsheets, and formatting reports, everything happens on a scheduled basis—giving you more time to focus on strategy and content creation.

Key benefits:

• Unified reporting across Twitter and Facebook in a single document
• Consistent weekly insights without manual effort
• Professional HTML reports ready to share with stakeholders
• AI-powered analysis using GPT-4 to identify trends and opportunities
• Automated distribution to your entire marketing team

Ideal for: Marketing teams, social media managers, content strategists, and agencies managing multiple client accounts who need regular performance visibility.

Who Is It For

This workflow is perfect for:

• Marketing Departments managing brand social presence across multiple platforms
• Social Media Managers who need to demonstrate ROI and performance metrics
• Digital Agencies reporting to multiple clients on social performance
• Content Teams analyzing what resonates with their audience
• Executive Leadership requiring weekly performance summaries for decision-making
• Growth Teams tracking engagement trends to optimize content strategy

No coding experience required—this agent handles all the technical complexity while you focus on actionable insights.

Required Integrations

Twitter Integration

Why it's needed: Twitter is one of your primary social channels. This integration fetches your recent tweets, engagement metrics, and audience interaction data to include in your performance analysis.

Setup steps:

1. Navigate to the Integrations section in TaskAGI
2. Search for and select Twitter
3. Click Connect New Account
4. You'll be redirected to Twitter's authentication page
5. Log in with your Twitter account (use your business/brand account)
6. Review the requested permissions and click Authorize
7. Return to TaskAGI—your account is now connected

How to obtain API credentials:

• TaskAGI uses OAuth 2.0 authentication, so you don't need to manually generate API keys
• Ensure your Twitter account has API access enabled (available for most accounts)
• If you encounter access issues, verify your account isn't restricted and has completed phone verification

Configuration in TaskAGI:

• Select your connected Twitter account from the dropdown
• The agent will automatically use your account's credentials
• No additional configuration needed—the integration handles authentication

Facebook Graph Integration

Why it's needed: Facebook Graph API provides access to your page posts, reach, engagement, and audience demographics. This data complements Twitter metrics for a complete social picture.

Setup steps:

1. Go to Integrations → Facebook Graph
2. Click Connect New Account
3. Select the Facebook page you want to monitor (must be an admin)
4. Review permissions—you'll need access to page insights and posts
5. Click Authorize to grant TaskAGI access
6. Confirm the connection in TaskAGI

How to obtain API credentials:

• Facebook uses OAuth 2.0 through the Graph API
• You must be an admin or editor on the Facebook page
• TaskAGI handles token generation automatically—no manual setup required
• Tokens refresh automatically, so you won't need to re-authenticate

Configuration in TaskAGI:

• Choose your Facebook business page from the available options
• Verify the page name displays correctly
• The agent will pull posts from the last 7 days by default

OpenAI Integration

Why it's needed: OpenAI's GPT-4 model analyzes your raw social media data and generates intelligent insights, identifying trends, top-performing content, and actionable recommendations.

Setup steps:

1. Visit platform.openai.com
2. Create an account or log in to your existing OpenAI account
3. Navigate to API Keys in your account settings
4. Click Create New Secret Key
5. Copy the generated key (you won't see it again)
6. In TaskAGI, go to Integrations → OpenAI
7. Click Connect New Account
8. Paste your API key in the provided field
9. Click Verify & Save

How to obtain API credentials:

• You'll need an OpenAI account with billing enabled
• GPT-4 access requires a paid account (free trial credits work too)
• Estimated cost: $0.50-$2.00 per report depending on data volume
• Monitor your usage in the OpenAI dashboard to control costs

Configuration in TaskAGI:

• Model: Select gpt-4o (latest, most capable model)
• Temperature: Keep at 0.7 for balanced analysis
• Max tokens: Set to 2000 for comprehensive reports
• The prompt is pre-configured to analyze social media performance

Gmail Integration

Why it's needed: Gmail delivers your completed performance report directly to your marketing team's inbox, ensuring stakeholders receive insights without manual distribution.

Setup steps:

1. Go to Integrations → Gmail
2. Click Connect New Account
3. Select the Gmail account to send reports from (typically your business email)
4. Review the requested permissions (send emails, read contacts)
5. Click Authorize
6. Return to TaskAGI to confirm the connection

How to obtain API credentials:

• Gmail uses OAuth 2.0—no API keys needed
• Use your business Gmail account for professional reports
• If you have 2-factor authentication enabled, you may need to create an app-specific password
• TaskAGI handles all authentication securely

Configuration in TaskAGI:

• From Address: Automatically set to your connected Gmail account
• To Address: marketing@yourcompany.com (modify as needed)
• Subject: Pre-configured as "Weekly Social Media Performance Report - Twitter & Facebook"
• Body: Automatically populated with the HTML report from the previous node

Configuration Steps

Step 1: Define Your Agent Identity

The workflow begins with three note nodes for documentation:

• AGENT NAME OPTIONS: Name your agent something descriptive like "Weekly Social Media Reporter" or "Social Performance Analyzer"
• CATEGORY & INDUSTRY: Specify "Marketing" and your industry (e.g., "Technology," "E-commerce," "SaaS")
• WORKFLOW OVERVIEW: Add a brief description: "Automated weekly social media performance analysis and reporting"

These notes help you and your team understand the agent's purpose at a glance.

Step 2: Configure the Manual Trigger

The Manual Trigger node allows you to run this workflow on-demand:

• Click the trigger node to configure
• Set Trigger Type to "Manual"
• Optionally add a Schedule (e.g., every Monday at 9 AM) for automated weekly reports
• Save the trigger configuration

Step 3: Set Up Twitter Data Fetching

Node: Fetch Recent Tweets

• Integration: Select your connected Twitter account
• Parameters:
  • Time Period: Last 7 days (default)
  • Tweet Count: 50 (captures recent activity)
  • Include Metrics: Engagement, impressions, retweets, likes
• This node outputs raw tweet data to the next processing step

Step 4: Set Up Facebook Data Fetching

Node: Fetch Facebook Page Posts

• Integration: Select your connected Facebook page
• Parameters:
  • Time Period: Last 7 days
  • Post Count: 30 (typical weekly volume)
  • Include Metrics: Reach, engagement, shares, comments
• Data flows to the Facebook formatting node

Step 5: Format Twitter Data

Node: Format Twitter Data

• Input: Connected to the Twitter fetch node
• Function: Standardizes tweet data into a consistent format
• Output Fields:
  • Tweet content
  • Engagement metrics (likes, retweets, replies)
  • Impressions and reach
  • Posting time and date

Step 6: Format Facebook Data

Node: Format Facebook Data

• Input: Connected to the Facebook fetch node
• Function: Standardizes Facebook metrics into matching format
• Output Fields:
  • Post content
  • Reach and impressions
  • Engagement (likes, comments, shares)
  • Post timing

Step 7: Merge Platform Data

Node: Merge Platform Data

• Inputs: Both formatted data nodes feed into this merge node
• Function: Combines Twitter and Facebook data into a unified dataset
• Output: Single data structure containing all social metrics

Step 8: Consolidate Social Data

Node: Consolidate Social Data

• Input: Merged platform data
• Function: Aggregates metrics (total reach, average engagement rate, top posts)
• Output: Summary statistics ready for analysis

Step 9: Generate HTML Performance Report

Node: Generate HTML Performance Report

• Integration: OpenAI (GPT-4o)
• Prompt: Pre-configured to analyze social media performance
• Input Data: Consolidated metrics from previous node
• Output: Professional HTML report with:
  • Executive summary
  • Platform-by-platform breakdown
  • Top-performing content
  • Engagement trends
  • AI-generated recommendations

Step 10: Send Email Report

Node: Send Email Report

• Integration: Gmail
• Configuration:
  • To: marketing@yourcompany.com (update with your team's email)
  • Subject: "Weekly Social Media Performance Report - Twitter & Facebook"
  • Body: [[nodes.11.content]] (automatically inserts the HTML report)
  • Format: HTML (renders beautifully in email clients)

Testing Your Agent

Test Execution

1. Run a test: Click the Test button in the workflow editor
2. Monitor execution: Watch each node process in real-time
3. Check logs: Review detailed logs for any errors or warnings
4. Verify outputs: Confirm data flows correctly between nodes

What to Verify at Each Step

Twitter & Facebook Fetch:

• ✅ Data successfully retrieved from both platforms
• ✅ Metrics include engagement, reach, and impressions
• ✅ Date range covers the last 7 days

Data Formatting:

• ✅ Twitter and Facebook data follow consistent structure
• ✅ All metrics are properly labeled
• ✅ No missing or null values

Merge & Consolidation:

• ✅ Combined dataset includes both platforms
• ✅ Summary statistics calculate correctly
• ✅ Total reach and engagement numbers are reasonable

Report Generation:

• ✅ HTML report generates without errors
• ✅ Report includes all expected sections
• ✅ AI analysis provides actionable insights
• ✅ Formatting is professional and readable

Email Delivery:

• ✅ Email sends successfully to the specified address
• ✅ HTML renders correctly in your email client
• ✅ All data displays properly
• ✅ Subject line is clear and professional

Expected Results and Success Indicators

A successful test execution will show:

• Green checkmarks on all nodes indicating completion
• Email received in your inbox within 1-2 minutes
• Professional HTML report with clear sections and formatting
• Accurate metrics matching your platform dashboards
• Meaningful AI insights about your content performance

Troubleshooting tips:

• If Twitter/Facebook fetch fails, verify API credentials are current
• If email doesn't arrive, check spam folder and verify recipient address
• If report looks incomplete, ensure all integrations are properly connected
• Review node logs for specific error messages

Once testing is complete, your agent is ready for production use. Schedule it to run automatically each week, and enjoy hands-free social media reporting!