> ## 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.

# Visión general de la API de Comentarios

> Publica, responde, obtén y elimina comentarios en una publicación social

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} />

Los endpoints de Comentarios permiten a tus usuarios publicar, responder, obtener y eliminar comentarios en sus publicaciones.
Hay cuatro tipos de IDs de comentarios: ID de publicación de Ayrshare, ID de publicación social, ID de comentario de Ayrshare e ID de comentario social.
Cada uno de estos IDs se usa con fines diferentes.

## Tipos de ID de comentario

### Comentarios con ID de publicación de Ayrshare

El flujo típico es: cuando publicas una publicación mediante Ayrshare, obtienes el ID de publicación de Ayrshare.
Luego puedes usar este [ID de publicación de Ayrshare](/apis/overview#ayrshare-post-id) para administrar los comentarios en esa publicación.

Plataformas admitidas: Bluesky, Facebook Pages, Instagram, LinkedIn, Reddit, Threads, TikTok, Twitter y YouTube.

Por ejemplo:

<Steps>
  <Step title="Publicar una publicación">
    Usa el endpoint [/post](/apis/post/post) para publicar una publicación mediante Ayrshare, que puede enviarse a varias redes sociales en una sola llamada.

    En la respuesta se incluye el [ID de publicación de Ayrshare](/apis/overview#ayrshare-post-id) de nivel superior.

    ```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="Publicar un comentario">
    Usa el endpoint [/comments](/apis/comments/post-comment) para publicar un comentario con el ID de publicación de Ayrshare.
    El comentario se publicará automáticamente en todas las redes sociales donde se publicó la publicación original.
    Por ejemplo, si publicaste en Facebook e Instagram, el comentario aparecerá en ambas plataformas.

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

  <Step title="Obtener comentarios">
    Usa el endpoint [/comments](/apis/comments/get-comments) para obtener los comentarios de la publicación con el ID de publicación de Ayrshare.
    Esto devolverá todos los comentarios de cada red social donde se publicó la publicación.
    Por ejemplo, si publicaste en Facebook e Instagram, obtendrás comentarios de ambas plataformas.

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

### Comentarios con ID de publicación social

A veces puedes querer administrar comentarios de una publicación que no se publicó mediante Ayrshare.
En este caso puedes usar el [ID de publicación social](/apis/overview#social-post-id), que es el ID de publicación asignado por la red social.

<Note>
  Si la publicación se publicó mediante Ayrshare, usa [el ID de publicación de
  Ayrshare](/apis/comments/overview#comments-with-ayrshare-post-id).
</Note>

Por ejemplo:

<Steps>
  <Step title="Obtener el historial de publicaciones">
    Comienza obteniendo las publicaciones de Instagram publicadas fuera de Ayrshare con el [endpoint Get All Post History](/apis/history/history-platform).

    El endpoint devuelve una lista de publicaciones con el `id` social de la publicación.

    ```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>El `id` de publicación social también se devuelve en el campo `postIds` del [endpoint post](/apis/post/post).</Note>
  </Step>

  <Step title="Obtener comentarios de una publicación">
    Usa el `id` devuelto para [obtener todos los comentarios](/apis/comments/get-comments) de una publicación específica de Instagram usando el `id` social, `searchPlatformId` establecido en `true` y `platform` establecido en `instagram`.

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

  <Step title="Usa el ID de comentario para obtener detalles del comentario">
    El JSON devuelto en el paso anterior tendrá un `commentId` para cada comentario, que es el [ID de comentario social](/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>

### Comentarios con ID de comentario de Ayrshare

Administra comentarios en una publicación que fue publicada mediante Ayrshare usando el [ID de comentario de Ayrshare](/apis/overview#ayrshare-comment-id).
El ID de comentario de Ayrshare es el ID de comentario asignado por Ayrshare y se puede encontrar en el campo `commentId` en la respuesta al [publicar un comentario](/apis/comments/post-comment).

Se usa a menudo si deseas obtener detalles de un comentario en particular publicado mediante Ayrshare.

### Comentarios con ID de comentario social

Administra comentarios en una publicación que no fue publicada mediante Ayrshare usando el [ID de comentario social](/apis/overview#social-comment-id).
El ID de comentario social es el ID de comentario de la red social, no el ID de Ayrshare, y se puede encontrar en el campo `commentId` en la respuesta al [obtener comentarios](/apis/comments/get-comments).

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

Se usa a menudo si deseas obtener detalles de un comentario en particular publicado fuera de Ayrshare, como las respuestas de LinkedIn a los comentarios.

## Deshabilitar comentarios

Puedes deshabilitar los comentarios al publicar una publicación usando el campo `disableComments` en el [endpoint /post](/apis/post/post). Los comentarios solo se deshabilitarán en Instagram, LinkedIn y TikTok.

También puedes habilitar o deshabilitar comentarios en una publicación ya publicada usando el endpoint [update post](/apis/post/update-post) y el campo `disableComments`.

## Limitaciones de la plataforma

<Note>
  **TikTok — `DELETE /comments` es solo para comentarios propios.** [`DELETE /comments`](/apis/comments/delete-comments) en TikTok solo tiene éxito para comentarios creados por la propia cuenta autenticada de TikTok (tus propias respuestas). Intentar eliminar un comentario creado por otro usuario devuelve el `code: 328` de Ayrshare. Para moderar comentarios de terceros en tus propios videos de TikTok, contacta a soporte para que confirmemos qué está disponible para tu tipo de cuenta vinculada.
</Note>

```
```
