{
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/social/webhook/facebook",
      "description": "Handshake xác minh Webhook từ Facebook. Nhận hub.mode, hub.verify_token và hub.challenge. So sánh token bảo mật và trả về challenge string nếu hợp lệ."
    },
    {
      "method": "POST",
      "path": "/api/social/webhook/facebook",
      "description": "Nhận các events Webhook (Comments, Mentions, Direct Messages) từ Facebook/Instagram Graph API. Yêu cầu phải có header X-Hub-Signature-256 hợp lệ khớp với App Secret."
    },
    {
      "method": "POST",
      "path": "/api/social/webhook/tiktok",
      "description": "Endpoint nhận dữ liệu từ các sự kiện Webhook (ví dụ: Comments trên videos) từ mạng xã hội TikTok."
    },
    {
      "method": "GET",
      "path": "/api/social/messages",
      "description": "Lấy danh sách dữ liệu tin nhắn/bình luận đã được lưu trữ in-memory. Hỗ trợ Filter qua query params: platform (facebook|instagram|tiktok), sentiment (positive|negative|neutral) và Pagination (limit tối đa 200, offset)."
    },
    {
      "method": "GET",
      "path": "/api/social/messages/stats",
      "description": "Xem thống kê tổng hợp số lượng messages theo nền tảng, phân bố tỷ lệ cảm xúc (positive/neutral/negative) và tính toán tỷ lệ tổng thể đánh giá tiêu cực (negative_rate)."
    },
    {
      "method": "POST",
      "path": "/api/social/messages/analyze",
      "description": "API phục vụ việc debug AI sentiment analysis. Nhận payload JSON { \"text\": \"nội dung cần phân tích\" } và trả về kết quả cảm xúc (Positive, Negative, Neutral) lấy từ hàm phân tích gốc."
    },
    {
      "method": "DELETE",
      "path": "/api/social/messages/clear",
      "description": "Xoá hoàn toàn danh sách messages khỏi hệ thống in-memory và file social_messages.json."
    }
  ]
}