# Social Monitor Hub > Docs for Social Monitor Hub users and AI agents: connect channels, publish, handle comments via MCP or Open API. ## Hướng dẫn ### Bắt đầu - [Social Monitor Hub](https://monitor-docs.solobiz.academy/vi/index.md): Hub quản lý kênh Facebook, Instagram, Threads, YouTube: đăng bài, lên lịch, xử lý bình luận và cho AI agent làm thay qua API key. - [Quickstart](https://monitor-docs.solobiz.academy/vi/quickstart.md): 5 bước từ đăng nhập đến lúc có prompt sẵn để dán cho AI agent: đăng nhập, chọn workspace, kết nối kênh, tạo API key, dán prompt. ### Sử dụng Hub - [Kết nối kênh](https://monitor-docs.solobiz.academy/vi/guides/connect-channels.md): Kết nối Facebook Page, Instagram, Threads, YouTube vào workspace, gửi link kết nối 7 ngày cho chủ kênh và xử lý kênh hết hạn token. - [API key](https://monitor-docs.solobiz.academy/vi/guides/api-keys.md): Tạo và thu hồi API key cho AI agent: quyền viewer và editor, đặt tên theo agent, key chỉ hiện một lần, prompt chứa key thật. - [Đăng bài và lịch đăng](https://monitor-docs.solobiz.academy/vi/guides/publishing-and-scheduler.md): Tạo bài, đăng ngay hoặc lên lịch tối đa 30 ngày, sửa bài đến 2 phút trước giờ đăng, loại bài từng nền tảng và upload ảnh/video. - [Hộp bình luận](https://monitor-docs.solobiz.academy/vi/guides/comment-inbox.md): Xem, trả lời, nhắn riêng, ẩn và đánh dấu đã xử lý bình luận Facebook, Instagram, Threads, YouTube; phân biệt người và agent trả lời. - [Tổng quan và số liệu](https://monitor-docs.solobiz.academy/vi/guides/dashboard-and-stats.md): Đọc dashboard Tổng quan và trang Bài viết: KPI, xu hướng theo ngày, chia theo nền tảng, xếp hạng kênh và bài; số liệu đồng bộ khoảng 12 giờ một lần. - [Cảnh báo Telegram](https://monitor-docs.solobiz.academy/vi/guides/alerts-telegram.md): Nhận cảnh báo (ví dụ agent_idle khi agent ngừng xử lý bình luận) trong group hoặc topic Telegram bằng mã liên kết và lệnh /link. ### Khác - [Câu hỏi thường gặp](https://monitor-docs.solobiz.academy/vi/faq.md): Lỗi hay gặp khi dùng Hub: kênh không đăng được, popup binding_mismatch, quota YouTube, lỗi 429, key bị từ chối. - [Nhật ký thay đổi](https://monitor-docs.solobiz.academy/vi/changelog.md): Các thay đổi người dùng và agent nhìn thấy: giới hạn lịch 30 ngày, trường updated_by, lỗi chi tiết, URL media của web. ## AI Agent ### Kết nối agent - [Connect an AI agent](https://monitor-docs.solobiz.academy/agents/index.md): Two ways to connect an agent to Social Monitor Hub: MCP (preferred) or the HTTP Open API. - [Agent quickstart](https://monitor-docs.solobiz.academy/agents/quickstart.md): Landing page for AI agents: base URLs, auth, first calls, safety rules. - [Connect Claude Code](https://monitor-docs.solobiz.academy/agents/connect-claude-code.md): Add Social Monitor Hub as an MCP server in Claude Code. - [Connect Codex](https://monitor-docs.solobiz.academy/agents/connect-codex.md): Add Social Monitor Hub as an MCP server in Codex CLI. - [Connect via MCP JSON](https://monitor-docs.solobiz.academy/agents/connect-mcp-json.md): Generic mcpServers JSON for Cursor, Claude Desktop and other MCP clients. - [Connect Hermes and GrokBot](https://monitor-docs.solobiz.academy/agents/connect-hermes-grokbot.md): Hermes Agent (Nous Research) and GrokBot connect through standard MCP. - [Connect HTTP bots](https://monitor-docs.solobiz.academy/agents/connect-http-bots.md): MausBot and custom bots without an MCP client: plain HTTP with curl. ### Làm việc với Hub - [MCP tools](https://monitor-docs.solobiz.academy/agents/mcp-tools.md): All 15 MCP tools: roles, arguments, HTTP equivalents, errors. - [Publishing workflow](https://monitor-docs.solobiz.academy/agents/publishing-workflow.md): Create, schedule, track and cancel posts safely as an agent. - [Comment inbox loop](https://monitor-docs.solobiz.academy/agents/comment-inbox-loop.md): Poll comments with a cursor, reply once, handle errors. - [Safety rules](https://monitor-docs.solobiz.academy/agents/safety-rules.md): Rules every agent must follow: untrusted comments, key handling, rate limits. - [Prompt templates](https://monitor-docs.solobiz.academy/agents/prompt-templates.md): Copy-paste prompts that connect an AI agent to Social Monitor Hub. Same text the web app generates when you create an API key. ## API Reference ### Open API v1 - [Introduction](https://monitor-docs.solobiz.academy/api-reference/introduction.md): Open API v1: publish posts, seed first comments and run the comment inbox from scripts and AI agents. ### Endpoints #### Channels - [List channels](https://monitor-docs.solobiz.academy/api-reference/channels/list-channels.md): Channels connected to the key's workspace. `id` is the **platform** id (Facebook Page id, Instagram account id, Threads user id, YouTube channel id) - the value to pass in `channel_ids`. - [List channel groups](https://monitor-docs.solobiz.academy/api-reference/channels/list-channel-groups.md): Channel groups, each with its channels. - [Get one channel group](https://monitor-docs.solobiz.academy/api-reference/channels/get-one-channel-group.md): One group with its channels. Unknown id, malformed id or a group of another workspace gives 404 (`group_not_found` or `NotFoundException`). #### Posts - [List posts](https://monitor-docs.solobiz.academy/api-reference/posts/list-posts.md): Posts of the workspace, sorted by `scheduled_at` descending, paginated. Bad query types give 400. - [Queue a post](https://monitor-docs.solobiz.academy/api-reference/posts/queue-a-post.md): ⚠️ **Live action** - this publishes to real social channels on production (when the server has publishing enabled) and cannot be undone from the API for Facebook and Instagram. - [Get a post](https://monitor-docs.solobiz.academy/api-reference/posts/get-a-post.md): One post with its targets. A web user may edit a `pending` post up to 2 minutes before it publishes, so re-read it before relying on `scheduled_at` or `content` (see `updated_by`). - [Cancel pending targets](https://monitor-docs.solobiz.academy/api-reference/posts/cancel-pending-targets.md): ⚠️ **Live action** - acts on production: every target still `pending` becomes `cancelled`. - [Get target status of a post](https://monitor-docs.solobiz.academy/api-reference/posts/get-target-status-of-a-post.md): Without `channel_id`: array of every target. With `channel_id`: that one target (404 `target_not_found` when the channel is not in the post). - [Delete the published post of one target (Threads only)](https://monitor-docs.solobiz.academy/api-reference/posts/delete-the-published-post-of-one-target-threads-only.md): ⚠️ **Live action** - removes a live post from the real platform account on production. #### Comments - [Queue first comments on a published post](https://monitor-docs.solobiz.academy/api-reference/comments/queue-first-comments-on-a-published-post.md): ⚠️ **Live action** - queues comments that the worker posts from the real channels on production. - [List comment jobs of a post](https://monitor-docs.solobiz.academy/api-reference/comments/list-comment-jobs-of-a-post.md): Every comment job of the post, from `comment_seedings` and from `POST /comments`. Job `status`: `pending`, `sending`, `sent`, `failed`, `unverified` (never re-sent). #### Inbox - [Read the comment feed](https://monitor-docs.solobiz.academy/api-reference/inbox/read-the-comment-feed.md): Cursor feed of new comments (Facebook, Instagram, Threads, YouTube). Each comment appears exactly once per cursor. - [Get one comment with context](https://monitor-docs.solobiz.academy/api-reference/inbox/get-one-comment-with-context.md): A comment with its post, parent comment, the channel's own replies in the thread (up to 20) and the action history (up to 10, never exposes keys). Read `actions` before replying: the hub does not block a second reply to the same comment under a different `Idempotency-Key`. - [Inbox flags and reply limits](https://monitor-docs.solobiz.academy/api-reference/inbox/inbox-flags-and-reply-limits.md): Whether the inbox is enabled for the workspace, the reply limits, and replies sent in the last hour per channel. Use it to pace yourself before hitting 429. - [Reply publicly to a comment](https://monitor-docs.solobiz.academy/api-reference/inbox/reply-publicly-to-a-comment.md): ⚠️ **Live action** - posts a public reply to a real customer's comment on production. A sent reply cannot be recalled through the API. - [Send a private message (DM) to the comment author](https://monitor-docs.solobiz.academy/api-reference/inbox/send-a-private-message-dm-to-the-comment-author.md): ⚠️ **Live action** - sends a real direct message to a real customer on production. One private message per comment, ever (`already_private_replied`). - [Mark a comment handled without replying](https://monitor-docs.solobiz.academy/api-reference/inbox/mark-a-comment-handled-without-replying.md): ⚠️ **Live action** - changes the real inbox state of the workspace: the comment is marked handled by this key (visible to the team on the web). Nothing is sent to the platform. - [Hide or unhide a comment on the platform](https://monitor-docs.solobiz.academy/api-reference/inbox/hide-or-unhide-a-comment-on-the-platform.md): ⚠️ **Live action** - hides or shows a real comment on the live social platform on production. ## OpenAPI Specs - [openapi](/api-reference/openapi.yaml) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [English (10 pages)](https://monitor-docs.solobiz.academy/_llms/en.txt): Guides. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.