Hướng dẫn vận hành PULSE cho 1990 Agency

1. Tạo dữ liệu campaign trong Admin

Vào Admin.html. Đây là nơi team 1990 thêm, sửa, xoá dữ liệu nội bộ trước khi có backend thật.

2. KPI, timeline và alert hoạt động thế nào?

PULSE so sánh KPI đã cam kết với số liệu thực tế lấy từ đúng public posts/videos đã book. Influencer không cần login hay connect account; team 1990 chỉ cần nhập đúng URL public để ScrapeCreators/n8n pull metrics.

Sau khi xử lý xong, vào Alerts.html và bấm resolve. Trạng thái này được lưu trong localStorage để refresh vẫn còn.

3. Thêm public post URL để n8n lấy số liệu

Mỗi booking nên có URL bài public của influencer. Ví dụ TikTok video URL, Instagram reel/post URL, Facebook post URL.

4. n8n lấy data social mỗi ngày như thế nào?

n8n không gọi social platform trực tiếp từ browser. Cách đơn giản và dễ debug hơn là để n8n chạy lịch, gọi ScrapeCreators API, kiểm tra dữ liệu trả về, rồi gửi JSON chuẩn vào backend/PULSE.

Workflow family nên có trong n8n

5. Payload chuẩn để import thử trong Admin/Data

Trong phase front-end, bạn có thể bấm Nạp payload mẫu trong Admin/Data hoặc paste JSON đã normalize để mô phỏng backend/n8n sync. File mẫu nằm ở sample-scrapecreators-payload.json. PULSE mặc định merge dữ liệu vào localStorage; khi test pilot thật, mở app với ?api=1 để đọc/ghi qua backend tối thiểu.

Dành cho team kỹ thuật: xem backend/README.md để chạy API local, docs/PILOT_RUNBOOK.md để làm checklist campaign thật, và import workflow mẫu n8n/PULSE-Core-Pull-Posts.workflow.json vào n8n trước khi chỉnh endpoint ScrapeCreators thật.

{
  "syncMeta": {
    "source": "scrapecreators",
    "orchestrator": "n8n",
    "runId": "n8n-scrapecreators-sample-20260428-0900",
    "lastSyncedAt": "2026-04-28T09:00:00+07:00",
    "staleAfterHours": 6
  },
  "posts": [
    {
      "id": "post_bk1_1",
      "bookingId": "bk1",
      "campaignId": "c1",
      "influencerId": "inf1",
      "platform": "tiktok",
      "url": "https://www.tiktok.com/@creator/video/123",
      "platformPostId": "123",
      "caption": "Public campaign video pulled by ScrapeCreators",
      "thumbnailUrl": "https://cdn.example.com/thumbs/123.jpg",
      "pullStatus": "ok",
      "views": 950000,
      "likes": 43000,
      "comments": 1200,
      "shares": 3100,
      "saves": 900,
      "reach": 700000,
      "lastPulledAt": "2026-04-28T09:00:00+07:00",
      "source": "scrapecreators",
      "errorMessage": ""
    },
    {
      "id": "post_bk4_missing_url",
      "bookingId": "bk4",
      "campaignId": "c1",
      "influencerId": "inf4",
      "platform": "tiktok",
      "url": "",
      "pullStatus": "missing_url",
      "errorMessage": "Staff must add the public post URL before n8n can pull metrics."
    }
  ]
}

6. Debug n8n khi số liệu không cập nhật

7. Share report cho khách hàng

Client View chỉ là campaign-level, read-only. Khách không được edit, không thấy admin, không thấy booking fee/cost nội bộ.

8. Vì sao chọn ScrapeCreators + n8n?

9. Step-by-step để go live với 1 campaign thật

Go live nên làm theo kiểu "pilot nhỏ nhưng thật": chọn một campaign, nối dữ liệu thật, kiểm tra report với internal team trước, rồi mới share cho client.