Cuadro de diálogo de contenido compartido

El cuadro de diálogo de contenido compartido ofrece a los usuarios la posibilidad de publicar una historia individual en su biografía, la biografía de un amigo, un grupo o un mensaje privado de Messenger. No necesita el inicio de sesión con Facebook ni permisos ampliados, por lo que se trata de la forma más sencilla de activar el uso compartido en la web.

En esta documentación, se describe cómo implementar el cuadro de diálogo de contenido compartido en la web. Si quieres implementarlo en una app para celulares, consulta Compartir en iOS y Compartir en Android.

A continuación, se muestra un ejemplo del cuadro de diálogo de contenido compartido donde aparece un vínculo a la biografía de un usuario.

En la imagen anterior, aparece la opción Compartir en tu biografía seleccionada en la lista desplegable para elegir el público con el que deseas compartir el contenido. Esa lista no aparece cuando una persona se encuentra en un navegador que no inició sesión con una cookie. Lo mismo aplica si la app usa el cuadro de diálogo de feed en vez del cuadro de diálogo de contenido compartido o si la app utiliza la vista web de iframe.

Si eres webmaster de una página que se comparte en Facebook, incluye las metaetiquetas de Open Graph para personalizar la historia que se comparte en Facebook. Es importante que marques el sitio web con etiquetas de Open Graph con el fin de controlar la forma en que aparece tu contenido en Facebook. Para obtener más información, consulta Guía para webmasters sobre el uso compartido.

Compartir contenido con redireccionamiento de URL

Para compartir un vínculo con redireccionamiento de URL, usa el código que aparece a continuación. Los saltos de línea se incluyen a fin de facilitar la lectura, pero debes quitarlos cuando uses este código.

https://www.facebook.com/dialog/share?
  app_id=145634995501895
  &display=popup
  &href=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https%3A%2F%2Fdevelopers.facebook.com%2Ftools%2Fexplorer

Compartir contenido con el SDK de Facebook para JavaScript

El cuadro de diálogo de contenido compartido está disponible en el SDK de Facebook para JavaScript mediante la FB.ui function con el parámetro del método share. Usa el siguiente fragmento de código para abrir el cuadro de diálogo de contenido compartido.

FB.ui({
  method: 'share',
  href: 'https://developers.facebook.com/docs/',
}, function(response){});

¡Pruébalo!

Parámetros

Los siguientes son los parámetros del cuadro de diálogo de contenido compartido.

Parámetro	Descripción	¿Obligatorio?
`app_id`	Identificador único de tu app.	Sí. Se proporciona automáticamente cuando usas el SDK.
`display`	Forma en que se muestra el cuadro de diálogo de contenido compartido. Redireccionamiento de URL: el valor de `display` es `page`. El cuadro de diálogo de contenido compartido es una página completa que aparece dentro de Facebook.com. SDK de Facebook para JavaScript: el valor de la pantalla es alguno de los siguientes: Un `iframe` modal para las personas que iniciaron sesión en tu app `async` cuando se usa dentro de un juego en Facebook.com Una ventana `popup` para el resto de las personas Puedes forzar el tipo `popup` cuando usas el SDK de Facebook para JavaScript, en caso de ser necesario. Apps web para celulares: el valor de `display` es siempre `touch`. SDK de Facebook para iOS o Android: el SDK especifica `display` automáticamente y elige el tipo de pantalla adecuado para el dispositivo.	Sí. Se proporciona automáticamente cuando usas el SDK.
`hashtag`	Un hashtag para agregarlo al contenido compartido. Las personas pueden eliminar el hashtag en el cuadro de diálogo de contenido compartido. El hashtag debería incluir el símbolo "hash", por ejemplo `#facebook`. El valor predeterminado es `null`.	No
`href`	El enlace para compartir contenido. El valor predeterminado es la URL actual.	Es obligatorio cuando usas el SDK.
~~`redirect_uri`~~ Obsoleto	~~La URL a la que redirigirá cuando una persona hace clic en un botón del cuadro de diálogo de contenido compartido.~~	~~Sí. Se proporciona automáticamente cuando usas el SDK.~~
~~`mobile_iframe`~~ Obsoleto	~~`true` para abrir el cuadro de diálogo de contenido compartido en un iframe en la parte superior de tu sitio web. Esta opción está disponible solo para dispositivos móviles, no para computadoras~~	~~`false`~~

Datos de la respuesta

Solo se produce una respuesta si el usuario inició sesión en tu app mediante el inicio de sesión con Facebook.

Parámetro	Descripción
`error_message`	Un mensaje de error.

Más información

Prácticas recomendadas de uso compartido