> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tổng quan về Comments API

> Đăng, trả lời, lấy và xóa bình luận trên một bài đăng mạng xã hội

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["premium"]} maxPackRequired={false} />

Các endpoint Comments cho phép người dùng của bạn đăng, trả lời, truy xuất và xóa bình luận trên các bài đăng của họ.
Có bốn loại ID bình luận: Ayrshare Post ID, Social Post ID, Ayrshare Comment ID và Social Comment ID.
Mỗi ID trong số này được sử dụng cho các mục đích khác nhau.

## Các Loại ID Bình luận

### Bình luận với Ayrshare Post ID

Luồng điển hình là khi bạn xuất bản một bài đăng qua Ayrshare, bạn nhận được Ayrshare Post ID.
Sau đó, bạn có thể sử dụng [Ayrshare Post ID](/apis/overview#ayrshare-post-id) này để quản lý bình luận trên bài đăng đó.

Các nền tảng được hỗ trợ: Bluesky, Facebook Pages, Instagram, LinkedIn, Reddit, Threads, TikTok, Twitter, và YouTube.

Ví dụ:

<Steps>
  <Step title="Xuất bản một Bài đăng">
    Sử dụng endpoint [/post](/apis/post/post) để xuất bản một bài đăng qua Ayrshare, có thể được gửi đến nhiều mạng xã hội trong một lệnh gọi duy nhất.

    Trong phần trả về là [Ayrshare Post ID](/apis/overview#ayrshare-post-id) cấp cao nhất.

    ```json {12} theme={"system"}
    {
        "status": "success",
        "errors": [],
        "postIds": [
        {
            "status": "success",
            "id": "106638148652329_591370753547555",
            "postUrl": "https://www.facebook.com/106638148652329/posts/591370753547555",
            "platform": "facebook"
        }
        ],
        "id": "E4UdUr1yRbvI7qqCSlaq", // Ayrshare Post ID
        "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc055",
        "post": "What an amazing day",
        "validate": true
    }
    ```
  </Step>

  <Step title="Đăng một Bình luận">
    Sử dụng endpoint [/comments](/apis/comments/post-comment) để đăng một bình luận với Ayrshare Post ID.
    Bình luận sẽ được tự động đăng lên mọi mạng xã hội nơi bài đăng gốc được xuất bản.
    Ví dụ, nếu bạn đã xuất bản bài đăng lên Facebook và Instagram, bình luận sẽ xuất hiện trên cả hai nền tảng.

    ```http theme={"system"}
    POST https://api.ayrshare.com/api/comments/:id
    ```
  </Step>

  <Step title="Lấy Bình luận">
    Sử dụng endpoint [/comments](/apis/comments/get-comments) để lấy các bình luận cho bài đăng với Ayrshare Post ID.
    Điều này sẽ trả về tất cả bình luận từ mọi mạng xã hội nơi bài đăng đã được xuất bản.
    Ví dụ, nếu bạn đã đăng lên Facebook và Instagram, bạn sẽ nhận được bình luận từ cả hai nền tảng.

    ```http theme={"system"}
    GET https://api.ayrshare.com/api/comments/:id
    ```
  </Step>
</Steps>

### Bình luận với Social Post ID

Đôi khi bạn có thể muốn quản lý bình luận trên một bài đăng không được xuất bản qua Ayrshare.
Trong trường hợp này, bạn có thể sử dụng [Social Post ID](/apis/overview#social-post-id), là ID bài đăng do mạng xã hội gán.

<Note>
  Nếu bài đăng được xuất bản qua Ayrshare, hãy sử dụng [Ayrshare Post
  ID](/apis/comments/overview#comments-with-ayrshare-post-id).
</Note>

Ví dụ:

<Steps>
  <Step title="Lấy Lịch sử Bài đăng">
    Bắt đầu bằng cách lấy các bài đăng Instagram được xuất bản bên ngoài Ayrshare với [endpoint Get All Post History](/apis/history/history-platform).

    Endpoint trả về một danh sách các bài đăng với `id` xã hội của bài đăng.

    ```json {13} theme={"system"}
    {
        "status": "success",
        "posts": [
            {
                "mediaUrl": "https://scontent.cdninstagram.com/v/t51.2885-15/7531.jpg",
                "permalink": "https://www.instagram.com/p/B5OBT3ygpfg/",
                "commentsCount": 0,
                "created": "2022-05-20T17:26:03Z",
                "likeCount": 0,
                "mediaProductType": "FEED",
                "mediaType": "IMAGE",
                "username": "thegoodone",
                "id": "17833140557332933", // Instagram Social Post ID
                "thumbnailUrl": "https://scontent-lga3-2.cdninstagram.com/v/t51..jpg",
                "post": "The #Mandalorian is on tonight instead of Friday",
                "postUrl": "https://www.instagram.com/p/B5OBT3ygpfg/"
            },
        ]
    }
    ```

    <Note>Post `id` xã hội cũng được trả về trong trường `postIds` của [endpoint post](/apis/post/post).</Note>
  </Step>

  <Step title="Lấy Bình luận trên một Bài đăng">
    Sử dụng `id` được trả về để [lấy tất cả các bình luận](/apis/comments/get-comments) cho một bài đăng Instagram cụ thể sử dụng `id` xã hội, `searchPlatformId` được đặt thành `true`, và `platform` được đặt thành `instagram`.

    ```http theme={"system"}
    GET https://api.ayrshare.com/api/comments/17833140557332933?platform=instagram&searchPlatformId=true
    ```
  </Step>

  <Step title="Sử dụng Comment ID để Lấy Chi tiết Bình luận">
    JSON được trả về từ bước trước sẽ có một `commentId` cho mỗi bình luận, đó là [social comment ID](/apis/overview#social-comment-id).

    ```json {5} theme={"system"}
    {
        "instagram": [
            {
                "comment": "What an amazing comment",
                "commentId": "17969247335804735", // Social Comment ID
                "created": "2024-11-26T11:49:00Z",
                "from": {
                "id": "103038435208332",
                "username": "john_smith"
                },
                "hidden": false,
                "likeCount": 3,
                "platform": "instagram",
                "postId": "18231730279304333",
                "username": "john_smith"
            }
        ]
    }

    ```
  </Step>
</Steps>

### Bình luận với Ayrshare Comment ID

Quản lý các bình luận trên bài đăng đã được xuất bản qua Ayrshare bằng cách sử dụng [Ayrshare Comment ID](/apis/overview#ayrshare-comment-id).
Ayrshare comment ID là ID bình luận được gán từ Ayrshare và có thể được tìm thấy trong trường `commentId` trong phản hồi khi [đăng một bình luận](/apis/comments/post-comment).

Điều này thường được sử dụng nếu bạn muốn lấy chi tiết về một bình luận cụ thể được xuất bản qua Ayrshare.

### Bình luận với Social Comment ID

Quản lý các bình luận trên bài đăng không được xuất bản qua Ayrshare bằng cách sử dụng [Social Comment ID](/apis/overview#social-comment-id).
Social comment ID là ID bình luận từ mạng xã hội, không phải Ayrshare ID, và có thể được tìm thấy trong trường `commentId` trong phản hồi khi [lấy bình luận](/apis/comments/get-comments).

```http theme={"system"}
GET https://api.ayrshare.com/api/comments/17969247335804735?platform=instagram&searchPlatformId=true&commentId=true
```

Điều này thường được sử dụng nếu bạn muốn lấy chi tiết về một bình luận cụ thể được xuất bản bên ngoài Ayrshare, chẳng hạn như các câu trả lời LinkedIn cho các bình luận.

## Vô hiệu hóa Bình luận

Bạn có thể vô hiệu hóa bình luận khi xuất bản một bài đăng bằng cách sử dụng trường `disableComments` trong [endpoint /post](/apis/post/post). Bình luận sẽ chỉ bị vô hiệu hóa cho Instagram, LinkedIn, và TikTok.

Bạn cũng có thể bật hoặc tắt bình luận trên một bài đăng đã được xuất bản bằng cách sử dụng endpoint [update post](/apis/post/update-post) và trường `disableComments`.

## Hạn chế Nền tảng

<Note>
  **TikTok — `DELETE /comments` chỉ dành cho bình luận do chính bạn tạo.** [`DELETE /comments`](/apis/comments/delete-comments) trên TikTok chỉ thành công đối với các bình luận do chính tài khoản TikTok đã xác thực tạo (các câu trả lời của chính bạn). Cố gắng xóa một bình luận do người dùng khác tạo trả về Ayrshare `code: 328`. Để kiểm duyệt các bình luận của bên thứ ba trên video TikTok của riêng bạn, hãy liên hệ với support để chúng tôi có thể xác nhận những gì có sẵn cho loại tài khoản đã liên kết của bạn.
</Note>

```
```
