> ## 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.
# Visão geral da Comments API
> Publique, responda, obtenha e exclua comentários em uma publicação 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
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.
{maxPackRequired && window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
Max Pack required
}
;
};
Os endpoints de Comments permitem que seus usuários publiquem, respondam, obtenham e excluam comentários em suas publicações.
Existem quatro tipos de IDs de comentários: Ayrshare Post ID, Social Post ID, Ayrshare Comment ID e Social Comment ID.
Cada um desses IDs é usado para propósitos diferentes.
## Tipos de ID de comentário
### Comentários com Ayrshare Post ID
O fluxo típico é: quando você publica uma publicação via Ayrshare, recebe o Ayrshare Post ID.
Você pode então usar esse [Ayrshare Post ID](/apis/overview#ayrshare-post-id) para gerenciar comentários nessa publicação.
Plataformas suportadas: Bluesky, Facebook Pages, Instagram, LinkedIn, Reddit, Threads, TikTok, Twitter e YouTube.
Por exemplo:
Use o endpoint [/post](/apis/post/post) para publicar uma publicação via Ayrshare, que pode ser enviada para várias redes sociais em uma única chamada.
No retorno está o [Ayrshare Post ID](/apis/overview#ayrshare-post-id) de nível 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
}
```
Use o endpoint [/comments](/apis/comments/post-comment) para publicar um comentário usando o Ayrshare Post ID.
O comentário será publicado automaticamente em todas as redes sociais onde a publicação original foi publicada.
Por exemplo, se você publicou no Facebook e no Instagram, o comentário aparecerá em ambas as plataformas.
```http theme={"system"}
POST https://api.ayrshare.com/api/comments/:id
```
Use o endpoint [/comments](/apis/comments/get-comments) para obter os comentários da publicação com o Ayrshare Post ID.
Isso retornará todos os comentários de todas as redes sociais onde a publicação foi publicada.
Por exemplo, se você publicou no Facebook e no Instagram, obterá comentários de ambas as plataformas.
```http theme={"system"}
GET https://api.ayrshare.com/api/comments/:id
```
### Comentários com Social Post ID
Às vezes você pode querer gerenciar comentários em uma publicação que não foi publicada via Ayrshare.
Nesse caso, você pode usar o [Social Post ID](/apis/overview#social-post-id), que é o ID da publicação atribuído pela rede social.
Se a publicação foi publicada via Ayrshare, use [o Ayrshare Post
ID](/apis/comments/overview#comments-with-ayrshare-post-id).
Por exemplo:
Comece obtendo as publicações do Instagram publicadas fora do Ayrshare com o [endpoint Get All Post History](/apis/history/history-platform).
O endpoint retorna uma lista de publicações com o `id` social da publicação.
```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/"
},
]
}
```
O `id` da publicação social também é retornado no campo `postIds` do [endpoint post](/apis/post/post).
Use o `id` retornado para [obter todos os comentários](/apis/comments/get-comments) de uma publicação específica do Instagram usando o `id` social, `searchPlatformId` definido como `true` e `platform` definido como `instagram`.
```http theme={"system"}
GET https://api.ayrshare.com/api/comments/17833140557332933?platform=instagram&searchPlatformId=true
```
O JSON retornado da etapa anterior terá um `commentId` para cada comentário, que é o [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"
}
]
}
```
### Comentários com Ayrshare Comment ID
Gerencie comentários em uma publicação que foi publicada via Ayrshare usando o [Ayrshare Comment ID](/apis/overview#ayrshare-comment-id).
O Ayrshare comment ID é o ID do comentário atribuído pelo Ayrshare e pode ser encontrado no campo `commentId` na resposta ao [publicar um comentário](/apis/comments/post-comment).
Isso é frequentemente usado quando você quer obter detalhes sobre um comentário específico publicado via Ayrshare.
### Comentários com Social Comment ID
Gerencie comentários em uma publicação que não foi publicada via Ayrshare usando o [Social Comment ID](/apis/overview#social-comment-id).
O social comment ID é o ID do comentário da rede social, não o ID do Ayrshare, e pode ser encontrado no campo `commentId` na resposta ao [obter comentários](/apis/comments/get-comments).
```http theme={"system"}
GET https://api.ayrshare.com/api/comments/17969247335804735?platform=instagram&searchPlatformId=true&commentId=true
```
Isso é frequentemente usado quando você quer obter detalhes sobre um comentário específico publicado fora do Ayrshare, como respostas do LinkedIn a comentários.
## Desabilitar comentários
Você pode desabilitar comentários ao publicar uma publicação usando o campo `disableComments` no [endpoint /post](/apis/post/post). Os comentários serão desabilitados apenas para Instagram, LinkedIn e TikTok.
Você também pode habilitar ou desabilitar comentários em uma publicação já publicada usando o endpoint [update post](/apis/post/update-post) e o campo `disableComments`.
## Limitações de plataforma
**TikTok — `DELETE /comments` é apenas para autoria própria.** [`DELETE /comments`](/apis/comments/delete-comments) no TikTok só funciona para comentários criados pela própria conta autenticada do TikTok (suas próprias respostas). Tentar excluir um comentário criado por outro usuário retorna Ayrshare `code: 328`. Para moderação de comentários de terceiros nos seus próprios vídeos do TikTok, entre em contato com o suporte para confirmarmos o que está disponível para o seu tipo de conta vinculada.
```
```