Cuadro de diálogo de envío

El cuadro de diálogo de envío permite a los usuarios enviar contenido en privado a determinados amigos. Los usuarios tendrán la opción de compartir un enlace en privado en forma de mensaje de Facebook. El cuadro de diálogo de envío no requiere permisos ampliados.

Los mensajes de Facebook son un canal de comunicación de persona a persona; no están pensados para que las aplicaciones envíen mensajes o animen a los usuarios a enviar spam a sus amigos. En general, los juegos de Facebook.com deben utilizar las solicitudes para informar de la situación en el juego, por ejemplo, para avisarte de tu turno, invitar a otras personas a utilizar la aplicación o enviar mensajes a varias personas.

Debes ofrecer el cuadro de diálogo de envío en situaciones en las que, de lo contrario, el usuario recurriría al correo electrónico.

Ejemplos de integración

Puedes agregar este cuadro de diálogo a tu sitio web mediante el SDK de Facebook para JavaScript o realizando un redireccionamiento completo a una URL. El cuadro de diálogo de envío no es compatible con dispositivos móviles.

JavaScript

Puedes cargar la misma URL del cuadro de diálogo de envío al utilizar el SDK de Facebook para JavaScript:

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

Redireccionamiento de URL

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/

Parámetros

Parámetro Descripción

app_id

Identificador único de tu aplicación. Obligatorio.

redirect_uri

URL a la que se redirigirá cuando una persona haga clic en un botón del cuadro de diálogo. Obligatorio si se utiliza el redireccionamiento de URL.

display

Determina cómo se muestra el cuadro de diálogo. En prácticamente todos los casos, la mejor opción será el valor predeterminado, por lo que no será necesario que lo especifiques.

  • Si utilizas el cuadro de diálogo de redireccionamiento de URL, se mostrará a página completa, dentro de Facebook.com. Este tipo de visualización se denomina page.
  • Si utilizas el SDK de Facebook para JavaScript, se adoptará de forma predeterminada el tipo iframe modal en el caso de las personas que inicien sesión en tu aplicación o async cuando se utilice dentro de un juego en Facebook.com, y una ventana popup para todos los demás casos.

to

Identificador de usuario de un destinatario. Cuando aparezca el cuadro de diálogo, el remitente podrá especificar a más personas como destinatarios.

link

Parámetro obligatorio. URL que se envía en el mensaje.


Datos de respuesta

Este cuadro de diálogo no envía datos de respuesta.