Borda de assinaturas

Você pode usar a borda /app/subscriptions da Graph API para configurar e gerenciar o produto Webhooks do seu aplicativo. Consulte a nossa documentação sobre /app/subscriptions para ver as operações que podem ser realizadas com essa borda e as permissões necessárias para isso. Este documento abrange somente algumas operações comuns.

Como criar assinaturas

Para assinar um objeto e os respectivos campos, envie uma solicitação POST à borda /app/subscriptions e inclua os parâmetros a seguir:

  • object – O tipo de objeto para o qual você quer configurar assinaturas de campo (por exemplo, user).
  • callback_url – A URL do seu ponto de extremidade.
  • verify_token – Uma string que será incluída quando enviarmos a você uma solicitação de verificação.
  • fields – Os campos que você quer assinar (por exemplo, photos).

Por exemplo, se o ID do aplicativo for 188559381496048 e você quiser receber uma notificação quando um usuário publicar uma nova foto, faça o seguinte:

Exemplo de solicitação

curl -F "object=user" \ -F "callback_url=https://your-clever-domain-name.com/webhooks" \ -F "fields=photos" \ -F "verify_token=your-verify-token" \ -F "access_token=your-app-access-token" \ "https://graph.facebook.com/188559381496048/subscriptions" 

Exemplo de resposta

Caso a operação seja bem-sucedida:

{
  "success": "true"
}

Como obter informações sobre a assinatura

Para ver as assinaturas de objeto e campo que foram configuradas para o seu aplicativo, envie uma solicitação GET à borda /app/subscriptions. Por exemplo, se o ID do aplicativo for 188559381496048, faça o seguinte:

Exemplo de solicitação

GET graph.facebook.com/188559381496048/subscriptions 

Exemplo de resposta

{ "data": [ { "object": "user", "callback_url": "https://your-clever-domain-name.com/webhooks", "active": true, "fields": [ { "name": "photos", "version": "v2.10" }, { "name": "feed", "version": "v2.10" } ] } ] }