Guias

Este guia descreve usos comuns da API de Grupos.

Obter publicações de um grupo

É possível realizar uma operação GET na borda /{group-id}/feed para obter publicações de um grupo.

Por padrão, as informações de identificação pessoal não serão incluídas na resposta. Para que as informações disponíveis publicamente do autor da publicação sejam incluídas na resposta, ele precisa conceder ao seu app a permissão groups_access_member_info.

Exemplo de solicitação

curl -i -X GET \ 
  "https://graph.facebook.com/{group-id}/feed?limit=5&access_token=EAACEdEos0..."

Exemplo de resposta

Exemplo de resposta com informações de identificação pessoal omitidas.

{
  "data": [
    {
      "message": "I love this group!",
      "updated_time": "2018-06-28T23:31:49+0000",
      "id": "554611227955614_1708186035931455"  //Post ID
    },
    {
      "message": "I like how linked groups look on mobile!",
      "updated_time": "2018-06-14T23:19:02+0000",
      "id": "554611227955614_1687969857953073"  //Post ID
    }
  ]
}

Exemplo de resposta

Exemplo de resposta em que o autor da publicação concedeu a permissão groups_access_member_info ao app.

{
  "data": [
    {
      "from": {
        "name": "Himanshu Sharma",
        "id": "512130107215"
      },
      "message": "I love this group!",
      "id": "554611227955614_1708186035931455"
    },
    {
      "from": {
        "name": "Ronak Patel",
        "id": "512130107214"
      },
      "message": "Just testing how linked groups look like on mobile!",
      "id": "554611227955614_1687969857953073"
    }
  ]
}

Limitações

• As chamadas somente retornarão dados de publicações criadas nos últimos 90 dias.

Obter usuários que compartilham campos públicos

É possível realizar uma operação GET na borda /{group-id}/opted_in_members para obter uma lista de usuários membros do grupo que concederam a permissão groups_access_member_info ao app. Esses membros optaram por compartilhar as próprias informações disponíveis publicamente com os apps instalados no grupo.

Exemplo de solicitação

curl -i -X GET \ 
  "https://graph.facebook.com/{group-id}/opted_in_members&access_token=EAACEdEos0..."

Exemplo de resposta

{
  "data": [
    {
      "name": "Himanshu Sharma",
      "id": "510765591715"
    },
    {
      "name": "Ronak Patel",
      "id": "410662391314"
    }
  ]
}

Obter webhooks de grupos que instalaram/desinstalaram o app

É possível assinar o campo group_install no objeto Application para receber uma notificação de webhook quando um membro instalar ou desinstalar o seu app em um grupo.

Exemplo de notificação

{
  "field": "group_install",
  "value": {
    "group_id": "954704787945183",
    "update_time": "1527459824",
    "verb": "add",
    "actor_id": "499619301"
  }
}