Bài 3 — Cài đặt n8n Cloud (bắt buộc trước khi build Agent)

n8n là nền tảng workflow automation — visual editor kéo thả nodes, hỗ trợ 400+ integrations (Telegram, Google Sheets, HTTP, OpenAI...). Khóa học khuyến nghị bắt đầu với n8n Cloud: không cần Docker, webhook HTTPS sẵn sàng cho Telegram Bot. Toàn bộ bài này bạn chỉ cần một trình duyệt và một email — làm theo đúng thứ tự dưới đây, khoảng 15 phút là xong.

Chuẩn bị trước khi bắt đầu: (1) một email bạn hay dùng (khuyến nghị Gmail để sau này OAuth Google Sheets cho nhanh), (2) mật khẩu mạnh, (3) đặt sẵn trong đầu một tên workspace không dấu, viết thường, ví dụ auto-marketing-vn. Ghi tên này ra giấy vì sau khi tạo sẽ khó đổi.

Bước 1 — Đăng ký n8n Cloud (khuyến nghị cho khóa học)

1. Mở trình duyệt, vào địa chỉ https://app.n8n.cloud/register (gõ tay hoặc bấm link ở trên) — nếu bị chuyển sang trang login nghĩa là bạn đã có tài khoản, hãy bấm chữ Sign up ở dưới ô đăng nhập.
2. Điền Email + Password (tối thiểu 8 ký tự, có chữ hoa và số) rồi bấm nút Sign up. Hoặc bấm Continue with Google để đăng ký nhanh bằng Gmail — cách này khỏi phải xác minh email.
3. Nếu đăng ký bằng email: mở hộp thư, tìm mail từ n8n (kiểm tra cả mục Spam/Promotions), bấm nút Verify email / Confirm để kích hoạt tài khoản.
4. Màn hình hỏi thông tin (tên, mục đích dùng) — cứ điền qua loa hoặc bấm Skip, không ảnh hưởng gì.
5. Đặt Workspace/Instance name: gõ auto-marketing-vn (chỉ chữ thường, số và dấu gạch ngang, KHÔNG dấu tiếng Việt, KHÔNG khoảng trắng). Tên này sẽ thành URL truy cập của bạn.
6. Nếu được hỏi Region/Data location: chọn khu vực gần Việt Nam nhất (thường là một region ở châu Á hoặc để mặc định) rồi bấm Create/Continue.
7. Đợi 30–60 giây n8n khởi tạo instance. Khi xong bạn sẽ được đưa thẳng vào editor với màn hình Overview hoặc nút Start from scratch.

Về gói dùng thử: bạn có 14 ngày trial Pro (khoảng 1000 executions, lưu lịch sử chạy ~5 ngày). Con số này thừa sức cho cả khóa học. Chưa cần nhập thẻ tín dụng ở bước này.

• ✅ Checkpoint Bước 1: URL trên thanh địa chỉ có dạng https://TEN-CUA-BAN.app.n8n.cloud và bạn thấy được canvas trống. Nếu đúng vậy là đăng ký thành công.

Bước 2 — Cấu hình timezone Việt Nam

Vì sao bắt buộc? Node Schedule Trigger và Cron chạy theo timezone của instance. Nếu để mặc định (thường là UTC), lịch đăng bài 7h/12h/19h của bạn sẽ lệch 7 tiếng so với giờ Việt Nam. Đặt Asia/Ho_Chi_Minh ngay từ đầu để tránh sửa lại toàn bộ sau này.

1. Cách A (khuyến nghị) — đặt cho từng workflow: mở một workflow bất kỳ → bấm menu ba chấm (⋯) góc trên phải → Settings → mục Timezone → chọn Asia/Ho_Chi_Minh → Save. Đây là cách chắc chắn nhất, ghi đè cả cấu hình instance.
2. Cách B — đặt mặc định cho cả instance: mở Admin dashboard (từ trang app.n8n.cloud, chọn workspace của bạn → nút Admin) → tab Settings → tìm Timezone → chọn Asia/Ho_Chi_Minh → Save.
3. Cách xác minh: tạo tạm một node Schedule Trigger, đặt Trigger at hour = giờ hiện tại + 1, chạy thử vào đúng giờ đó để chắc chắn nó khớp giờ VN (hoặc dùng expression {{ $now }} trong một node Set để xem giờ trả về).

• Tạo một Project/Folder tên auto-marketing-agents (menu bên trái → dấu + cạnh Projects, nếu gói của bạn hỗ trợ) để gom toàn bộ workflow khóa học vào một chỗ, khỏi lẫn với workflow test.
• Ghi lại URL instance dạng https://TEN-CUA-BAN.app.n8n.cloud vào file ghi chú — bạn sẽ cần nó khi cấu hình webhook Telegram ở Bài 5.

Lỗi thường gặp ở Bài 3

• Không nhận được email xác minh → kiểm tra Spam/Promotions; nếu vẫn không có, đăng ký lại bằng Continue with Google.
• Không tìm thấy mục Timezone trong Settings → giao diện Cloud đổi theo phiên bản; dùng Cách A (đặt trong Workflow Settings) là luôn có.
• Tên workspace bị báo trùng/không hợp lệ → thêm hậu tố như auto-marketing-vn-01, chỉ dùng a-z, 0-9 và dấu gạch ngang.
• Trial hết hạn giữa khóa → vào Billing chọn gói trả phí thấp nhất, hoặc chuyển sang self-host Docker (mục dưới) để dùng miễn phí không giới hạn.

n8n Cloud vs Self-host Docker — chọn cái nào?

• n8n Cloud: Setup ~2 phút, webhook public HTTPS sẵn, managed OAuth Google — tốt cho học + MVP Telegram. Chọn cái này nếu bạn mới bắt đầu.
• Self-host Docker: Kiểm soát data, execution không giới hạn (tùy server), miễn phí — nhưng cần VPS có IP public, domain + SSL và cấu hình biến WEBHOOK_URL thì Telegram mới gọi vào được.
• Khuyến nghị khóa học: học trên Cloud → chuyển self-host VPS khi lên production hoặc khi hết trial.

Tùy chọn — Self-host bằng Docker (làm sau khi cần production)

Chỉ làm phần này nếu bạn đã có VPS (ví dụ Ubuntu) đã cài Docker + Docker Compose và trỏ được một tên miền vào IP VPS. Người mới nên bỏ qua và học tiếp trên Cloud.

1. SSH vào VPS, tạo thư mục dự án: mkdir -p ~/n8n && cd ~/n8n
2. Tạo file docker-compose.yml với nội dung bên dưới (sửa yourdomain.com thành domain thật của bạn).
3. Chạy docker compose up -d để khởi động n8n ở chế độ nền.
4. Trỏ reverse proxy (Nginx/Caddy/Traefik) + SSL từ https://automation.yourdomain.com về cổng 5678, vì Telegram bắt buộc webhook phải là HTTPS.
5. Mở trình duyệt vào domain đó, tạo tài khoản owner đầu tiên (email + mật khẩu) — đây là admin của instance.

# docker-compose.yml — chỉ cần khi self-host
services:
  n8n:
    image: n8nio/n8n:latest
    restart: unless-stopped
    ports: ["5678:5678"]
    environment:
      # URL public HTTPS — Telegram/webhook gọi vào đây
      - WEBHOOK_URL=https://automation.yourdomain.com/
      - N8N_HOST=automation.yourdomain.com
      - N8N_PROTOCOL=https
      - GENERIC_TIMEZONE=Asia/Ho_Chi_Minh
      - TZ=Asia/Ho_Chi_Minh
      # Khóa mã hóa credentials — TẠO 1 LẦN, sao lưu cẩn thận, mất là mất hết credential
      - N8N_ENCRYPTION_KEY=doi-thanh-chuoi-ngau-nhien-dai
    volumes:
      - n8n_data:/home/node/.n8n
volumes:
  n8n_data:

• ⚠️ N8N_ENCRYPTION_KEY: đặt một chuỗi ngẫu nhiên dài rồi lưu vào nơi an toàn. Nếu container tự sinh key và bạn xóa volume/không backup, toàn bộ credential đã lưu sẽ không giải mã lại được.
• Backup định kỳ volume n8n_data (chứa workflow + credential đã mã hóa) — ví dụ cron dump ra file .tar hàng ngày.

Bài tập thực hành (nộp lại để tự chấm)

1. Hoàn tất đăng ký n8n Cloud và vào được canvas editor (thấy URL dạng ...app.n8n.cloud).
2. Đặt timezone Asia/Ho_Chi_Minh (theo Cách A hoặc B) và xác minh bằng expression {{ $now }}.
3. Tạo một workflow trống, đặt tên 00-sandbox, bấm Save (Ctrl/Cmd + S).
4. Chụp screenshot màn hình Overview + URL instance của bạn để làm bằng chứng đã hoàn thành.