A API de comentários do LinkedIn: o que ela permite a um app fazer
A PostCat AI não é afiliada ao LinkedIn.
A API de comentários do LinkedIn é a API socialActions/comments. Ela permite que um app escreva e leia comentários em publicações. Oferece métodos para obter um comentário, obter comentários de uma publicação ou de outro comentário, e criar, editar e apagar um comentário. Antes que um app possa buscar dados ou acessar dados de membros, ele precisa ser autorizado e autenticado.
Artem Luko
Founder do PostCat AI
0+
seguidores no LinkedIn
Ele fez crescer o próprio LinkedIn post por post. O PostCat AI é tudo que ele aprendeu, num lugar só.
Veja comoO que a API de comentários do LinkedIn permite a um app fazer
A documentação do LinkedIn lista estes métodos:
- Get a Comment
- Batch Get a Collection of Comments
- Get Comments on Shares
- Get Comments on Comments
- Create a Comment
- Edit a Comment
- Delete a Comment
Um único comentário é lido com uma requisição GET para https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments/{commentId}. Vários comentários podem ser lidos em uma só chamada com .../comments/ids=List({commentId}). Os comentários de uma publicação vêm de uma requisição GET para https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments.
Onde encontrar a documentação
A referência da API está no Microsoft Learn, onde o LinkedIn publica a documentação para desenvolvedores. Comece por Microsoft Learn: Comments API. A Central de Ajuda do LinkedIn cobre apenas o que os membros fazem no site e no app, não a API.
Permissões de que você precisa
Cada permissão define o que um app pode fazer. A tabela abaixo mantém a redação da documentação do LinkedIn.
| Permissão | O que ela permite a um app fazer | Acesso |
|---|---|---|
| w_member_social | Permite que um app publique, comente e curta publicações em nome de um membro autenticado | Listada em Share on LinkedIn na tabela de permissões abertas |
| w_member_social_feed | Permite que um app crie, modifique e apague comentários e reações em publicações em nome do membro | Permissão de membro (3-legged) para a Community Management API |
| r_member_social_feed | Permite que um app recupere publicações, reações e curtidas em nome de um membro autenticado | Restrita, concedida apenas a desenvolvedores selecionados |
| w_organization_social_feed | Permite que um app publique, comente e reaja em nome de uma organização | Restrita a organizações nas quais o membro tem um dos papéis de página de empresa |
As tabelas de permissões não são iguais em todas as versões da API. Confira a versão que você pretende usar antes de confiar em uma linha.
Campos do comentário: autor, mensagem e respostas
Todo comentário tem um autor (actor), que é a URN de quem está comentando. O campo do autor é obrigatório. Um autor urn:li:person faz um comentário pessoal, com o membro como publicador. Um autor urn:li:organization ou urn:li:organizationBrand faz um comentário de organização que um membro escreveu em nome da entidade.
O campo da mensagem é um texto obrigatório, e pode incluir links para pessoas e organizações. Conteúdos como imagens são opcionais.
Uma resposta é um comentário aninhado. O campo parentComment guarda a URN do comentário pai. Esse campo não está disponível para comentários de primeiro nível.
Para editar um comentário, a requisição usa o cabeçalho X-RestLi-Method: PARTIAL_UPDATE e um patch que define o texto da mensagem. Delete a Comment é um dos métodos listados.
Ativar e desativar comentários
Os comentários de uma publicação são ativados e desativados por meio de outra API, a Social Metadata API. Defina commentsState como CLOSED para desativar comentários, e como OPEN para ativá-los. Desativar comentários apaga todos os comentários existentes na thread. As reações permanecem. Reativar comentários permite que as pessoas voltem a escrever comentários na thread.
A Social Metadata API aceita apenas URNs de thread. Ela rejeita qualquer escrita que use uma URN de comentário. Para criar e recuperar um comentário, use a Comments API. As contagens resumidas são commentSummary.count, que inclui as respostas, e commentSummary.topLevelCount, que deixa as respostas de fora.
Comentar manualmente no LinkedIn
Se você quiser sentir como é um comentário antes de chamar a API, faça isso manualmente primeiro. Os passos seguem LinkedIn Help: Comment on posts and reply to a comment.
- Clique em Comment abaixo da publicação, ou clique na caixa de texto que diz Add a comment.
- Digite seu comentário.
- Opcionalmente, clique no ícone de emoji, no ícone de GIF ou no ícone de imagem.
- Clique em Comment.
Para responder, clique em Reply abaixo de um comentário, ou clique na caixa de texto que diz Add a reply, digite sua resposta e clique em Reply. Os membros também podem limitar os comentários apenas às conexões, o que impede que pessoas que não sejam conexões de 1º grau comentem.
Para editar seu próprio comentário, clique no ícone More à direita do comentário, clique no ícone Edit, faça as alterações e clique em Save Changes. O comentário passa então a mostrar (edited) acima dele. Os passos seguem LinkedIn Help: Edit a comment.
Como começar
Leia a referência da versão da API que você pretende usar, porque as linhas de permissão mudam entre versões. Comece com uma única chamada de leitura em uma publicação sua. Adicione escritas somente depois que as leituras retornarem o que você espera.
O que as páginas de ajuda que lemos não dizem
As páginas de ajuda que lemos não informam:
- Limites de taxa e cotas da API.
- Taxas ou preços de acesso à API.
- Como criar um app, como obter acesso ao Marketing Developer Platform ou à Community Management, quanto tempo leva a aprovação e se desenvolvedores individuais se qualificam.
- Se um app sem direitos de administrador pode ler comentários em publicações de outros membros.
- O formato da requisição para Delete a Comment, os limites de paginação e de contagem, e qual versão da API é a atual.
PostCat AI e comentários
A PostCat AI é um produto independente, não operado nem endossado pelo LinkedIn. Ela responde a comentários nas publicações que publica, após aprovação ou por conta própria, e funciona apenas por meio da API oficial do LinkedIn. Os preços estão em a página de preços.
Fontes
- Comments API - LinkedIn (learn.microsoft.com)
- LinkedIn Help: Comment on posts and reply to a comment
- LinkedIn Help: Edit comments in your LinkedIn feed
- Getting Access to LinkedIn APIs - LinkedIn (learn.microsoft.com)
- Increasing Access - LinkedIn (learn.microsoft.com)
- Community Management - Overview - LinkedIn (learn.microsoft.com)
- Migration Guide for Community Management API - LinkedIn (learn.microsoft.com)
- Integration Requirements for Community Management - LinkedIn (learn.microsoft.com)
- Social Metadata API - LinkedIn (learn.microsoft.com)
- Posts API - LinkedIn (learn.microsoft.com)


