Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.sellfern.com/llms.txt

Use this file to discover all available pages before exploring further.

Sellfern cung cấp một workflow n8n sẵn dùng để lấy phân tích hàng tuần của bạn và đăng một báo cáo có định dạng lên Discord hoặc Slack tự động — không cần mã. Nhập mẫu workflow, thêm thông tin đăng nhập của bạn và nhóm của bạn sẽ nhận được tóm tắt doanh thu vào mỗi thứ Hai lúc 9 giờ sáng.

​
Workflow làm gì

Workflow chứa bốn node chạy tuần tự:
  1. Schedule trigger — kích hoạt vào mỗi thứ Hai lúc 9:00 sáng
  2. Get Sellfern Analytics — gọi GET /api/v2/analytics/summary?period=last_7_days với token API của bạn
  3. Format Report — chuyển đổi phản hồi thành một thông báo dễ đọc với doanh thu, số đơn hàng, COGS, lợi nhuận gộp và phần trăm biên
  4. Post to Discord — gửi thông báo đã định dạng đến URL webhook Discord (hoặc Slack) của bạn
Đầu ra đã định dạng trông như thế này: 
Sellfern Weekly Revenue Report
Period: last_7_days (2026-05-15 – 2026-05-22)

Revenue:       $12,450.00
Orders:        87
COGS:          $7,890.00
Gross Profit:  $4,560.00
Margin:        36.6%

​
Điều kiện tiên quyết

  • Một instance n8n (tự lưu trữ hoặc n8n Cloud)
  • Một token API Sellfern với phạm vi analytics:read
  • Một URL webhook Discord hoặc URL webhook đến Slack

​
Nhập workflow

1

Mở hộp thoại Import

Trong n8n, vào Workflows trong thanh bên trái và nhấp + Add workflow, sau đó chọn Import from file.
2

Tải lên tệp workflow

Tải lên examples/n8n-weekly-report.json từ kho lưu trữ Sellfern. n8n nhập tất cả bốn node và các kết nối của chúng tự động.
3

Thêm token API Sellfern dưới dạng thông tin đăng nhập

Nhấp vào node Get Sellfern Analytics. Dưới Authentication, tạo một thông tin đăng nhập Header Auth mới:
  • Name: Authorization
  • Value: Bearer sk_live_YOUR_TOKEN
Lưu thông tin đăng nhập. n8n lưu nó an toàn và tái sử dụng cho tất cả các node HTTP Sellfern.
4

Đặt URL webhook

Nhấp vào node Post to Discord và đặt trường URL thành URL webhook Discord của bạn. Nếu bạn đang sử dụng Slack, hãy thay thế node này bằng node Slack của n8n (hoặc một node HTTP Request đăng tới URL webhook đến Slack) và đặt body thành { "text": "{{$json.content}}" }.
5

Kích hoạt workflow

Chuyển workflow sang Active. n8n sẽ chạy nó vào mỗi thứ Hai lúc 9:00 sáng theo schedule trigger. Lần thực thi đầu tiên xảy ra vào thời gian theo lịch tiếp theo.
Trước khi kích hoạt, sử dụng nút Test workflow của n8n để chạy workflow ngay lập tức và xác minh rằng cuộc gọi API thành công và thông báo xuất hiện trong kênh Discord hoặc Slack của bạn. Điều này cho phép bạn phát hiện các vấn đề về thông tin đăng nhập hoặc định dạng mà không cần chờ đến thứ Hai.

​
Tùy chỉnh workflow

Thay đổi lịch Nhấp vào node trigger Every Monday 9am và điều chỉnh ngày và giờ. Ví dụ, để chạy mỗi ngày trong tuần lúc 8 sáng, đặt triggerAtWeekday thành [1, 2, 3, 4, 5] và triggerAtHour thành 8. Điều chỉnh định dạng báo cáo Mở node code Format Report. JavaScript ở đó xây thông báo từng dòng từ các trường phản hồi API (revenue, order_count, cogs, gross_profit, margin_pct). Chỉnh sửa mảng lines để thêm, xóa hoặc định dạng lại bất kỳ trường nào. Chuyển từ Discord sang Slack Thay thế node Post to Discord bằng một node HTTP Request trỏ tới URL webhook đến Slack. Thay đổi body yêu cầu thành: 
{
  "text": "={{$json.content}}"
}
Đầu ra của node Format Report giống nhau bất kể đích đến.
Workflow gọi GET /api/v2/analytics/summary với period=last_7_days. Token API Sellfern của bạn phải có phạm vi analytics:read. Bạn có thể xác minh phạm vi của token trong Settings → API Tokens.