Pular para o conteúdo

A API de comentários do LinkedIn: o que ela permite a um app fazer

6 min de leitura

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 como

O 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ãoO que ela permite a um app fazerAcesso
w_member_socialPermite que um app publique, comente e curta publicações em nome de um membro autenticadoListada em Share on LinkedIn na tabela de permissões abertas
w_member_social_feedPermite que um app crie, modifique e apague comentários e reações em publicações em nome do membroPermissão de membro (3-legged) para a Community Management API
r_member_social_feedPermite que um app recupere publicações, reações e curtidas em nome de um membro autenticadoRestrita, concedida apenas a desenvolvedores selecionados
w_organization_social_feedPermite que um app publique, comente e reaja em nome de uma organizaçãoRestrita 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.

  1. Clique em Comment abaixo da publicação, ou clique na caixa de texto que diz Add a comment.
  2. Digite seu comentário.
  3. Opcionalmente, clique no ícone de emoji, no ícone de GIF ou no ícone de imagem.
  4. 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)

Perguntas frequentes

Sim. A API socialActions/comments permite que um app escreva e leia comentários em publicações. Ela tem métodos para obter, criar, editar e apagar comentários. A referência está no Microsoft Learn.

Comece pelo próximo post do seu time.

Conecte os perfis do LinkedIn do seu time e comece com o teste grátis.