Kênh

MADIAD Hub đăng được lên 22 kênh. Không phải kênh nào cũng là mạng xã hội: danh sách còn có blog, chat nội bộ, fediverse, một nền tảng thương mại và một hệ gửi bản tin email. Mỗi kênh nhận một số loại bài nhất định, và kết nối theo một trong hai cách.

Hub đăng được lên những nền tảng nào

Mười ba mạng xã hội quen thuộc: TikTok, Instagram, YouTube, Facebook, LinkedIn, X, Threads, Pinterest, Reddit, Bluesky, Google Business Profile, Telegram, Discord, cộng Slack, Mastodon, Nostr, Lemmy, dev.to, Hashnode, WordPress, Whop và listmonk.

Không loại bài nào đi tới được cả 22 kênh. Con số 22 là số kênh Hub kết nối được, không phải số kênh một bài đăng chạm tới: bài chữ, ảnh và video mỗi loại tới một tập kênh khác nhau. Bảng ngay dưới là chỗ duy nhất nên tra. Đừng nói “đăng lên 22 kênh” cho một bài video, API sẽ từ chối bằng 400 invalid_request kèm tên kênh sai.

Mỗi kênh nhận loại bài nào

platforms được kiểm theo bảng này trước khi gửi đi bất cứ thứ gì. Đưa video cho một blog, hay bài chữ cho YouTube, sẽ nhận 400 invalid_request có nêu tên kênh sai, chứ không đăng được một nửa rồi mới báo lỗi.

Kênh	`platform`	Chữ	Ảnh	Video	Kết nối bằng
TikTok	`tiktok`	-	✅	✅	OAuth
Instagram	`instagram`	-	✅	✅	OAuth
YouTube	`youtube`	-	-	✅	OAuth
Facebook	`facebook`	✅	✅	✅	OAuth
LinkedIn	`linkedin`	✅	✅	✅	OAuth
X	`x`	✅	✅	✅	OAuth
Threads	`threads`	✅	✅	✅	OAuth
Pinterest	`pinterest`	-	✅	✅	OAuth
Reddit	`reddit`	✅	✅	✅	OAuth
Bluesky	`bluesky`	✅	✅	✅	Mật khẩu ứng dụng
Google Business Profile	`google_business`	✅	✅	✅	OAuth
Telegram	`telegram`	✅	✅	✅	Bot của bạn
Discord	`discord`	✅	✅	✅	Webhook kênh
Slack	`slack`	✅	-	-	Incoming webhook
Mastodon	`mastodon`	✅	✅	✅	Access token
Nostr	`nostr`	✅	-	-	Khoá riêng
Lemmy	`lemmy`	✅	✅	-	Tài khoản Lemmy
dev.to	`devto`	✅	-	-	API key
Hashnode	`hashnode`	✅	-	-	Personal access token
WordPress	`wordpress`	✅	✅	✅	Application password
Whop	`whop`	✅	-	-	API key
listmonk	`listmonk`	✅	-	-	API user

Dùng đúng giá trị platform như trong bảng: x (không phải twitter), google_business (có gạch dưới), devto (không có dấu chấm).

Reddit và Bluesky hiện chưa kết nối được (Reddit kiểm ngày 22/09/2026, Bluesky ngày 13/09/2026). Hai kênh này đang được nâng cấp, thử lại cũng không giúp được. Trên trang kết nối, ô của chúng hiện ở dạng mờ kèm ghi chú, thay vì để khách bấm vào ngõ cụt. Gọi kết nối cho một trong hai kênh sẽ nhận 503 platform_unavailable. Kênh đã kết nối từ trước vẫn chạy và vẫn đăng bài bình thường, các kênh còn lại trong bảng không bị ảnh hưởng.

Hai cách kết nối

Kênh dùng OAuth

Phần lớn kênh được kết nối bằng cách đăng nhập trên trang kết nối: bạn gửi khách một đường dẫn, họ cấp quyền cho MADIAD Hub ngay trên màn hình của chính nền tảng đó, không có thông tin nhạy cảm nào đi qua bạn. Xem Profile để biết luồng tạo link kết nối.

Kênh nhập thông tin thủ công

Slack, Mastodon, Nostr, Lemmy, dev.to, Hashnode, WordPress, Whop, listmonk, Telegram và Discord không có màn hình cấp quyền OAuth. Thay vào đó khách cung cấp một thông tin xác thực (webhook URL, API key, hoặc application password) sẽ được kiểm tra với chính nền tảng rồi lưu ở dạng mã hoá. Kết nối bằng POST /v1/connections/{platform}. Request nào cũng cần profile_id và name (tuỳ chọn), kèm các trường riêng của từng kênh:

Kênh	Endpoint	Trường
Telegram	`/v1/connections/telegram`	`bot_token`, `chat_id`
Discord	`/v1/connections/discord`	`webhook_url`
Slack	`/v1/connections/slack`	`webhook_url`
Mastodon	`/v1/connections/mastodon`	`instance_url`, `access_token`
Nostr	`/v1/connections/nostr`	`private_key` · `relays` (tuỳ chọn)
Lemmy	`/v1/connections/lemmy`	`instance_url`, `username`, `password`, `community`
dev.to	`/v1/connections/devto`	`api_key`
Hashnode	`/v1/connections/hashnode`	`pat`, `publication_id`
WordPress	`/v1/connections/wordpress`	`site_url`, `username`, `application_password`
Whop	`/v1/connections/whop`	`api_key`, `experience_id`
listmonk	`/v1/connections/listmonk`	`instance_url`, `username`, `password`, `list_id`

curl -X POST https://api.madiad.com/v1/connections/wordpress \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "'"$PROFILE_ID"'",
    "site_url": "https://blog.congty.com",
    "username": "bientap",
    "application_password": "xxxx xxxx xxxx xxxx xxxx xxxx",
    "name": "Blog công ty"
  }'

Gọi thành công sẽ trả về trạng thái kết nối mới nhất của Profile. instance_url và site_url bắt buộc là URL https://. Mọi trường đều bắt buộc, trừ trường được ghi là tuỳ chọn: bỏ trống thì nền tảng dùng mặc định của nó (Nostr dùng danh sách relay mặc định). Gửi chuỗi rỗng KHÔNG giống với bỏ trống.

Khoá riêng Nostr không đổi và không thu hồi được. Khác API key hay application password, ai giữ khoá này là nắm quyền với danh tính đó vĩnh viễn. Hãy dùng một danh tính Nostr lập riêng để đăng tự động, đừng dùng khoá cá nhân của bạn.

WordPress cần Application Password, không phải mật khẩu đăng nhập. Tạo tại Người dùng → Hồ sơ → Application Passwords. Tinh thần tương tự với Lemmy và listmonk: hai kênh này có dùng mật khẩu tài khoản, nên hãy cấp một tài khoản chỉ dùng để đăng bài.

WordPress báo sai tên đăng nhập dù bạn nhập đúng

Hub gửi nguyên ba ô bạn nhập (địa chỉ website, tên đăng nhập, Application Password) để website của bạn xác nhận. Khi cả ba đều đúng mà vẫn nhận câu “Invalid WordPress username or application password”, lý do thường nằm ở máy chủ của website, không phải ở thông tin bạn nhập. Tự kiểm bằng một lệnh, chạy trên máy của bạn (đừng gửi Application Password cho ai, kể cả cho MADIAD):

curl -u 'TEN_DANG_NHAP:APPLICATION_PASSWORD' https://website-cua-ban/wp-json/wp/v2/users/me

Website trả lời	Nghĩa là	Việc cần làm
Thông tin tài khoản, có `"id"`	Website nhận đăng nhập này	Kết nối lại trên Hub; còn lỗi thì gửi MADIAD giờ bạn thử
`rest_not_logged_in`	Thông tin đăng nhập không tới được WordPress: máy chủ bỏ header `Authorization` dọc đường	Nhờ đơn vị hosting của website cho header `Authorization` đi qua. Với Apache hoặc LiteSpeed, đó là dòng `RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]` trong `.htaccess`
`incorrect_password` hoặc `invalid_username`	WordPress nhận được và từ chối	Kiểm lại tên đăng nhập (tên tài khoản, không phải tên hiển thị) và tạo Application Password mới
Trang `403` thay vì JSON	Tường lửa hoặc lớp chống bot của hosting chặn	Nhờ hosting cho phép gọi `/wp-json/` từ máy chủ bên ngoài

Mở được /wp-json/ bằng trình duyệt chưa đủ để kết luận: trình duyệt không gửi thông tin đăng nhập, và lớp chống bot thường cho trình duyệt qua trong khi chặn yêu cầu từ máy chủ.

Chọn endpoint nào

Ba endpoint đăng bài ứng với ba cột ở bảng trên:

POST /v1/posts/text: mọi kênh có ✅ ở cột Chữ
POST /v1/posts/photos: mọi kênh có ✅ ở cột Ảnh
POST /v1/posts/video: mọi kênh có ✅ ở cột Video

Một lần gọi có thể liệt kê bất kỳ nhóm kênh nào cùng nhận loại bài đó. Muốn vừa lên nền tảng video vừa lên blog thì gửi hai lần gọi. Đó là hai loại bài khác nhau, và mỗi lần tính là một lượt đăng.

Phạm vi của Analytics

Analytics có số liệu cho mười kênh: TikTok, Instagram, YouTube, Facebook, LinkedIn, X, Threads, Pinterest, Reddit và Bluesky. Google Business Profile và toàn bộ kênh nhập thủ công không trả về số người theo dõi, phạm vi tiếp cận hay tương tác. Một webhook Discord hay một danh sách email thì không có lượng người theo dõi để đọc. Hãy bỏ chúng khỏi platforms khi gọi Analytics.

Bắt đầu

Khái niệm

Tích hợp

Tham chiếu API

Hub đăng được lên những nền tảng nào

Mỗi kênh nhận loại bài nào

Hai cách kết nối

Kênh dùng OAuth

Kênh nhập thông tin thủ công

WordPress báo sai tên đăng nhập dù bạn nhập đúng

Chọn endpoint nào

Phạm vi của Analytics

​Hub đăng được lên những nền tảng nào

​Mỗi kênh nhận loại bài nào

​Hai cách kết nối

​Kênh dùng OAuth

​Kênh nhập thông tin thủ công

​WordPress báo sai tên đăng nhập dù bạn nhập đúng

​Chọn endpoint nào

​Phạm vi của Analytics

Hub đăng được lên những nền tảng nào

Mỗi kênh nhận loại bài nào

Hai cách kết nối

Kênh dùng OAuth

Kênh nhập thông tin thủ công

WordPress báo sai tên đăng nhập dù bạn nhập đúng

Chọn endpoint nào

Phạm vi của Analytics