Chuyển đến nội dung chính
Một profile đại diện cho một tập hợp các tài khoản mạng xã hội đã kết nối, thường là một thương hiệu, khách hàng, hoặc tài khoản con mà bạn đăng nội dung thay mặt. Các profile là nền tảng đa thuê của MADIAD Hub: một API key có thể quản lý nhiều profile, và mỗi bài đăng chỉ nhắm đến đúng một profile.
Your account (one API key)
├── profile: Acme Coffee   → Instagram, Facebook, TikTok
├── profile: Acme Tea      → Instagram, X
└── profile: Client — Nova → LinkedIn, YouTube

Tạo profile

curl -X POST https://api.madiad.com/v1/profiles \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "friendly_name": "Acme Coffee" }'
{
  "id": "prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z",
  "friendly_name": "Acme Coffee",
  "connect_url": "https://connect.madiad.com/o/abc123def456",
  "created_at": "2026-05-31T08:00:00Z"
}
Sử dụng id (prof_…) được trả về mỗi khi bạn đăng bài.

Kết nối tài khoản mạng xã hội

Mỗi profile bắt đầu ở trạng thái trống. Mở connect_url trong trình duyệt và đăng nhập vào từng nền tảng bạn muốn đăng nội dung. MADIAD Hub lưu trữ thông tin ủy quyền, vì vậy bạn không cần tự xử lý token của các nền tảng.
1

Mở URL kết nối

Gửi cho người dùng (hoặc chính bạn) connect_url được trả về khi tạo profile.
2

Ủy quyền từng nền tảng

Đăng nhập vào Instagram, Facebook, TikTok và các nền tảng khác. Các kết nối sẽ tồn tại cho đến khi bị thu hồi.
3

Đăng bài

Tham chiếu profile bằng id trong mọi request đăng bài.

Các nền tảng được hỗ trợ

Một profile có thể kết nối với bất kỳ nền tảng nào trong số sau: TikTok, Instagram, YouTube, Facebook, LinkedIn, X, Threads, Pinterest, Reddit, Bluesky và Google Business Profile. Bài đăng chỉ thành công trên các nền tảng mà profile đích đã thực sự kết nối. Nếu liệt kê một nền tảng chưa được kết nối, hệ thống sẽ trả về lỗi cho nền tảng đó.

Khi nào nên dùng nhiều profile

  • Agency: một profile cho mỗi khách hàng.
  • Nhóm đa thương hiệu: một profile cho mỗi thương hiệu.
  • Môi trường: các profile riêng biệt cho đối tượng thử nghiệm và sản xuất.