FAPI.UI.showNotification

Displays the user notification dialog. Allows specifying a default notification text and application custom arguments.

A notification is similar to an invitation, except that it can be sent to users who are already using the application.

ParameterRequiredDescription
textYesText that will be sent in the notification
paramsNoCustom data transmitted to the application when a user accepts the invitation. The data will be transmitted in the custom_args parameter. For more information, see application parameters.
Max length: 120 characters.
selected_uidsNoThe list of friend IDs that will already be selected when the invitation window opens.
20 IDs per request max.
Users must be in the friend list. Friends selected are only those who have been playing games recently.

Restrictions

Notifications are restricted to 20 per day per one user (50 for applications that are not launched). Before calling the method, you can check the restriction with the users.getCallsLeft method, indicating the special constant notifications.sendFromUser.

Example

function showNotification(){
    FAPI.UI.showNotification("Play in my game!", "arg1=val1");
}

Example with using selected_uids

function showNotification2(){
    var callback = function(status, result, data){
        if(result.length > 2){
            FAPI.UI.showNotification("Play in my game!", "arg1=val1", result[0] + ";" + result[1]);
        } else {
            alert("Not enough friends for using example");
        }
    }
    FAPI.Client.call({"method":"friends.get"},callback);
}