Bolta.get Comments

Goal

Fetch comments on specific posts or across recent posts to monitor conversations, identify response opportunities, and detect policy violations.

Which Agents Use This

• engagement — Monitor for questions to answer, compliments to acknowledge
• moderator — Scan for spam, harassment, or policy violations
• custom — Any agent needing comment monitoring

Hard Rules

1. MUST provide either post_id OR account_id (not neither)
2. SHOULD calculate spam_score and sentiment for each comment
3. SHOULD flag has_response to avoid duplicate replies
4. Filter options help agents prioritize (unanswered, flagged, spam_suspected)

Steps

1. Validate input

• Verify post_id OR account_id provided
• Validate since timestamp if provided

2. Fetch comments

• If post_id: fetch comments for that post
• If account_id: fetch comments across recent posts
• Apply since filter
• Apply filter (unanswered, flagged, spam_suspected)

3. Analyze comments

• Calculate spam_score (0-1, low = genuine, high = spam)
• Determine sentiment (positive, neutral, negative)
• Check has_response (did we already reply?)

4. Return comments array

• Include comment metadata, author, content, timestamps
• Include analysis (sentiment, spam_score, has_response)

Output

{
  "success": true,
  "count": 18,
  "comments": [
    {
      "comment_id": "uuid",
      "post_id": "uuid",
      "author": "@username",
      "content": "Great post! How does this compare to X?",
      "created_at": "2026-02-20T10:30:00Z",
      "sentiment": "positive",
      "spam_score": 0.02,
      "has_response": false
    }
  ]
}

Failure Handling

• If post_id and account_id both missing: return error "Provide post_id or account_id"
• If post_id not found: return error "Post not found"
• If platform API fails: return cached comments with warning

Example Usage

Scenario: Engagement agent checking unanswered questions

{
  "account_id": "uuid",
  "since": "2026-02-20T08:00:00Z",
  "filter": "unanswered"
}

Result: Receive list of unanswered comments since 8am for response drafting