Borda de assinaturas

É possível usar a borda /app/subscriptions para configurar e gerenciar o produto Webhooks no seu app. Consulte a documentação /app/subscriptions para ver quais operações podem ser realizadas com a borda e as permissões necessárias. Este documento aborda 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 sobre o qual você quer configurar a assinatura (por exemplo, user).
  • callback_url: o URL do ponto de extremidade.
  • verify_token uma string incluída sempre que solicitarmos uma verificação.
  • fields: os campos que você quer assinar (por exemplo, photos).

Por exemplo, caso o ID do app fosse 188559381496048 e você quisesse receber notificações quando usuários do app publicassem novas fotos, seria possível fazer 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 da assinatura

Para ver as assinaturas de objetos e campos configuradas no app, envie uma solicitação GET à borda /app/subscriptions. Por exemplo, se o ID do app fosse 188559381496048, você faria 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" } ] } ] }