FAPI.UI.showInvite

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

Unlike showNotification method it does not allow sending invitations to users who have been using this app.

ParameterRequiredDescription
textYesText that will be sent in the invitation
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.

Example

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

Example with using selected_uids

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