Boîte de dialogue Envoyer

Avec la boîte de dialogue Envoyer, les personnes peuvent envoyer, de manière privée, du contenu à des amis en particulier. Elles peuvent choisir de partager un lien sous la forme d’un message privé sur Facebook. La boîte de dialogue Envoyer ne nécessite aucune autorisation étendue.

Les messages Facebook sont un canal de communication entre personnes, pas un moyen pour les apps d’envoyer des messages ou d’encourager les personnes à envoyer sans cesse des messages à leurs amis. En général, les jeux sur Facebook.com doivent utiliser les demandes pour communiquer l’état dans le jeu (par exemple, lorsque c’est au tour du joueur de jouer), pour inviter des personnes à utiliser une app ou pour envoyer des messages à plusieurs personnes.

Vous devez proposer la boîte de dialogue Envoyer dans les situations où une personne enverrait normalement un e-mail.

Exemples d’intégration

Vous pouvez ajouter cette boîte de dialogue à votre site web avec le SDK Facebook pour JavaScript et la réalisation d’une redirection complète vers une URL. Elle n’est pas prise en charge sur les appareils mobiles.

JavaScript

Vous pouvez charger la même URL de boîte de dialogue Envoyer avec le SDK Facebook pour JavaScript :

FB.ui({
  method: 'send',
  link: 'http://www.nytimes.com/interactive/2015/04/15/travel/europe-favorite-streets.html',
});

Redirection d’URL

http://www.facebook.com/dialog/send?
  app_id=123456789
  &amp;link=http://www.nytimes.com/interactive/2015/04/15/travel/europe-favorite-streets.html
  &amp;redirect_uri=https://www.domain.com/

Paramètres

Paramètre	Description
`app_id`	L’identifiant unique de votre app. Obligatoire.
`redirect_uri`	L’URL vers laquelle une personne est redirigée après avoir cliqué sur un bouton de la boîte de dialogue. Obligatoire en cas de redirection d’URL.
`display`	Détermine comment la boîte de dialogue s’affiche. Dans presque tous les cas, vous n’aurez pas besoin d’indiquer ce paramètre, la valeur par défaut fonctionne mieux. Si vous utilisez la boîte de dialogue de redirection d’URL, celle-ci s’affichera en plein écran, sur Facebook.com. Ce type d’affichage est appelé `page`. Si vous utilisez le SDK Facebook pour JavaScript, l’affichage par défaut sera de type `iframe` modal pour les personnes connectées à votre app ou `async` lors d’une utilisation dans un jeu sur Facebook.com, et une fenêtre `popup` pour toutes les autres personnes.
`to`	L’ID d’utilisateur d’un destinataire. Lorsque la boîte de dialogue s’affiche, l’expéditeur peut indiquer des personnes supplémentaires en tant que destinataires.
`link`	Paramètre obligatoire. L’URL qui est envoyée dans le message.

Données de réponse

Cette boîte de dialogue ne génère pas de données de réponse.