With the Send Dialog people can privately send content to specific friends. They'll have the option to privately share a link as a Facebook message. The Send Dialog does not require any extended permissions.
Facebook messages are a channel for person-to-person communication, and not meant for apps to send messages, or encourage people to spam their friends. In general, games on Facebook.com should use requests to communicate in-game status such as its your turn, or inviting people to use an app, or sending messages to multiple people.
You should offer the Send Dialog in situations when someone would otherwise send an email.
You can add this dialog to your website with the Facebook SDK for JavaScript and by performing a full redirect to a URL. It is not supported on mobile devices.
You can load the same Send Dialog URL using the Facebook SDK for JavaScript:
FB.ui({ method: 'send', link: 'http://www.nytimes.com/interactive/2015/04/15/travel/europe-favorite-streets.html', });
http://www.facebook.com/dialog/send? app_id=123456789 &link=http://www.nytimes.com/interactive/2015/04/15/travel/europe-favorite-streets.html &redirect_uri=https://www.domain.com/
Parameter | Description |
---|---|
| Your app's unique identifier. Required. |
| The URL to redirect to after a person clicks a button on the dialog. Required when using URL redirection. |
| Determines how the dialog is rendered. In nearly all cases, you won't need to specify this and the default will work best.
|
| A user ID of a recipient. Once the dialog comes up, the sender can specify additional people as recipients. |
| Required parameter. The URL that is being sent in the message. |
There is no response data from this dialog.