`MessengerExtensions.getGrantedPermissions()` Reference

Messenger Extensions SDK

This method is a part of the Messenger Extensions SDK. For information on including the SDK in your site, see Add Messenger Extensions SDK.

The getGrantedPermissions() method of the Messenger Extensions SDK allows you to retrieve a list of permissions you are currently granted by the person that opened the webview.

Available Permissions
Method
Example
Parameters
permission_response Object

Available Permissions

When a person begins a conversation with the bot for the first time, these permissions are implicitly granted. There may be other situations where only one (or neither) is granted, such as encountering the bot via a plugin or ad, or encountering a page shared by a friend using a bot.

Permission	Scope	Description
`user_profile`	Per user, per bot.	Once granted, the developer may call the user profile API to obtain more information about the user.
`user_messaging`	Per user, per bot.	Once granted, the bot may message the user personally in a user-to-bot thread.

Method

MessengerExtensions.getGrantedPermissions(success, error)

Example

MessengerExtensions.getGrantedPermissions(function (permissions_response) {
  let permission = permissions_response.permissions // list of permissions granted
}, function() {
  // An error occurred
});

Parameters

Parameter	Type	Description
`success`	Function	Success callback function. Called if the Messenger Platform successfully retrieves the permission list. Receives the permission_response object as an argument.
`error`	Function	Error callback function. Called if Messenger was unable to retrieve the permission list.

`permission_response` Object

The permission_response object is passed to the success callback.

{
  "permissions":[
    "user_profile",
    "user_messaging"
  ]
}

Properties

Property	Type	Description
`permissions`	Array<String>	A list of the permissions that are currently granted.

MessengerExtensions.getGrantedPermissions() Reference