Hướng dẫn tạo App WordPress.com và kết nối với n8n

Tài liệu dành cho người mới, giúp bạn tạo WordPress.com Developer App,
lấy OAuth2 Token trong n8n và đăng bài tự động lên WordPress.com.

Tổng quan

1. Tổng quan cách hoạt động

Với WordPress.com, bạn không dùng Application Password như WordPress.org self-host.
Cách phù hợp hơn là dùng OAuth2.

Luồng hoạt động sẽ như sau:

WordPress.com Developer App
→ cấp Client ID và Client Secret
→ n8n dùng OAuth2 để xin quyền truy cập
→ n8n lấy Access Token
→ HTTP Request node đăng bài lên WordPress.com API

Ghi nhớ: Với WordPress.com, bạn nên dùng
OAuth2 API credential trong n8n, sau đó dùng
HTTP Request node để đăng bài.

Chuẩn bị

2. Chuẩn bị trước khi làm

Bạn cần có:

Thứ cần có	Ví dụ	Ghi chú
Blog WordPress.com	`https://congtythietkewebsitevn4u.wordpress.com/`	Đây là site bạn muốn đăng bài lên.
n8n đang chạy public HTTPS	`https://n8n.vn4u.vn`	OAuth2 cần URL callback truy cập được từ bên ngoài.
Tài khoản WordPress.com	Email đăng nhập WordPress.com	Tài khoản này phải có quyền đăng bài trên blog.

Lưu ý: Nếu n8n chỉ chạy ở localhost hoặc IP nội bộ,
OAuth2 callback có thể không hoạt động. Nên dùng domain HTTPS cho n8n.

WordPress.com

3. Tạo App trên WordPress.com Developer

Truy cập trang tạo app:

https://developer.wordpress.com/apps/

Bấm tạo app mới hoặc chỉnh sửa app hiện có.

Thông tin nên điền

Trường	Nội dung nên điền
Name	`n8n congtythietkewebsitevn4u`
Description	`App dùng để kết nối n8n và đăng bài tự động lên WordPress.com`
Website URL	`https://congtythietkewebsitevn4u.wordpress.com/`
Redirect URLs	Dán OAuth Redirect URL lấy từ n8n. Xem phần tiếp theo.
Javascript Origins	Để trống.
What is 6 + 6?	`12`
Type	Chọn `Web`.

Quan trọng: Trường Redirect URLs phải trùng chính xác
với OAuth Redirect URL trong n8n. Sai một ký tự cũng có thể lỗi.

Redirect URL

4. Lấy Redirect URL từ n8n

Trong n8n, vào:

Credentials
→ New
→ OAuth2 API

Trong màn hình tạo credential, n8n sẽ hiển thị một dòng tên là:

OAuth Redirect URL

Nó thường có dạng:

https://domain-n8n-cua-ban.com/rest/oauth2-credential/callback

Ví dụ nếu n8n của bạn chạy tại:

https://n8n.vn4u.vn

thì Redirect URL thường là:

https://n8n.vn4u.vn/rest/oauth2-credential/callback

Copy URL này và dán vào ô Redirect URLs
trong app WordPress.com Developer.

n8n OAuth2

5. Tạo OAuth2 Credential trong n8n

Trong n8n chọn loại credential:

OAuth2 API

Không chọn WordPress node credential, vì WordPress.com không dùng Application Password theo kiểu WordPress.org.

Cấu hình OAuth2 API

Trường trong n8n	Giá trị cần điền
Grant Type	`Authorization Code`
Authorization URL	`https://public-api.wordpress.com/oauth2/authorize`
Access Token URL	`https://public-api.wordpress.com/oauth2/token`
Client ID	Lấy trong app WordPress.com Developer.
Client Secret	Lấy trong app WordPress.com Developer.
Scope	`global`
Auth URI Query Parameters	Để trống.
Authentication	`Body`
Ignore SSL Issues	Tắt.
Allowed HTTP Request Domains	Có thể để `All`, hoặc điền `public-api.wordpress.com`.

Nếu bạn đang thấy Authentication = Header, hãy đổi sang
Body.

Kết nối

6. Kết nối tài khoản WordPress.com

Sau khi điền đủ thông tin trong OAuth2 credential:

Bấm Save.

Bấm Connect my account.

Trình duyệt sẽ mở trang WordPress.com để bạn đăng nhập và cấp quyền.

Sau khi cấp quyền, WordPress.com sẽ chuyển về n8n.

Nếu kết nối thành công, credential trong n8n sẽ báo trạng thái đã connected.

Workflow

7. Tạo workflow đăng bài trong n8n

Tạo workflow đơn giản trước để test:

Manual Trigger
→ Set
→ HTTP Request

Node 1: Manual Trigger

Dùng để bấm chạy thử thủ công.

Node 2: Set

Tạo dữ liệu bài viết mẫu:

{
  "title": "Bài test đăng từ n8n lên WordPress.com",
  "content": "<h2>Xin chào</h2><p>Đây là bài test được đăng tự động từ n8n.</p>",
  "status": "draft"
}

Khi mới test, luôn dùng draft để bài chỉ lưu nháp,
chưa đăng công khai.

HTTP Request

8. Cấu hình HTTP Request node

Thêm node HTTP Request sau node Set.

Trường	Giá trị
Method	`POST`
URL	`https://public-api.wordpress.com/rest/v1.1/sites/congtythietkewebsitevn4u.wordpress.com/posts/new`
Authentication	Chọn OAuth2 credential WordPress.com vừa tạo.
Send Body	Bật.
Body Content Type	`Form URL Encoded`

Body Parameters

Name	Value
`title`	`{{ $json.title }}`
`content`	`{{ $json.content }}`
`status`	`{{ $json.status }}`

Site ID trong URL có thể dùng domain WordPress.com:
congtythietkewebsitevn4u.wordpress.com

Test

9. Test đăng bài nháp

Sau khi cấu hình xong:

Bấm Execute Workflow trong n8n.

Vào WordPress.com Dashboard của site.

Kiểm tra mục:

Posts → Drafts

Nếu thấy bài test trong Drafts là bạn đã kết nối thành công.

Publish

10. Chuyển sang đăng công khai

Sau khi test ổn, đổi status từ:

draft

thành:

publish

Các trạng thái thường dùng:

Status	Ý nghĩa
`draft`	Lưu nháp, chưa công khai.
`publish`	Đăng công khai.
`private`	Bài riêng tư.
`pending`	Chờ duyệt.

Không nên để publish ngay từ đầu. Hãy test bằng
draft trước để tránh đăng lỗi hàng loạt.

Lỗi thường gặp

11. Lỗi thường gặp và cách xử lý

Lỗi	Nguyên nhân thường gặp	Cách xử lý
Redirect URI mismatch	Redirect URL trong WordPress.com app không trùng với n8n.	Copy đúng OAuth Redirect URL trong n8n và dán lại vào WordPress.com Developer App.
Invalid client	Sai Client ID hoặc Client Secret.	Kiểm tra lại Client ID và Client Secret trong app WordPress.com.
401 Unauthorized	Token chưa đúng, credential chưa connect, hoặc hết quyền.	Reconnect OAuth2 credential trong n8n.
403 Forbidden	Tài khoản WordPress.com không có quyền đăng bài lên site.	Kiểm tra tài khoản đang connect có quyền Author/Admin trên blog.
404 Not Found	Sai domain site trong URL API.	Kiểm tra lại URL: `sites/congtythietkewebsitevn4u.wordpress.com/posts/new`
Bài không hiện	Bài đang ở trạng thái nháp.	Vào `Posts → Drafts` để kiểm tra, hoặc đổi status thành `publish`.