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, en la de un amigo, en un grupo o en un mensaje privado de Messenger. El cuadro de diálogo de contenido compartido no requiere inicio de sesión con Facebook ni permisos ampliados, así que es la forma más sencilla de activar el uso compartido en la web.

Esta documentación describe cómo implementar el cuadro de diálogo de contenido compartido en la web. Para implementar el cuadro de diálogo de contenido compartido en una aplicación para móviles, consulta Compartir en iOS y Compartir en Android.

A continuación, tienes un ejemplo del cuadro de diálogo de contenido compartido que está compartiendo un enlace en la biografía de un usuario.

En la imagen anterior, se selecciona Compartir en tu propia biografía en la lista desplegable para elegir la audiencia con la que se va a compartir. La lista desplegable para elegir la audiencia con la que se va a compartir algo no aparece cuando la persona está en un navegador en el que no se ha iniciado sesión con una cookie. Esta situación también se da si la aplicación usa el cuadro de diálogo de contenido compartido de la sección de noticias o la vista web de iframe.

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

Compartir utilizando el redireccionamiento de URL

Para compartir un enlace utilizando el redireccionamiento de URL, utiliza el siguiente código. Se incluyen saltos de línea para facilitar la lectura. Elimina los saltos de línea cuando utilices 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 utilizando el SDK de Facebook para JavaScript

El cuadro de diálogo de contenido compartido está disponible en el SDK de Facebook para JavaScript utilizando la función FB.ui 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

A continuación encontrarás los parámetros del cuadro de diálogo de contenido compartido.

Parámetro	Descripción	¿Obligatorio?
`app_id`	Identificador único de la aplicación.	Sí. Se proporciona automáticamente cuando usas el SDK.
`display`	Cómo se representa 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 “display” es uno de los siguientes: Un cuadro de diálogo `iframe` para personas que han iniciado sesión en tu aplicación. `async` al utilizarse dentro de un juego en Facebook.com. Una ventana `popup` para todos los demás. Puedes forzar el tipo `popup` cuando uses el SDK de Facebook para JavaScript, si es necesario. Aplicaciones para web móvil: el valor de `display` es siempre `touch`. SDK de Facebook para iOS o Android: el SDK especifica `display` automáticamente y elige un tipo de visualización adecuado para el dispositivo.	Sí. Se proporciona automáticamente cuando usas el SDK.
`hashtag`	Hashtag para añadirlo al contenido compartido. Las personas pueden eliminar el hashtag en el cuadro de diálogo de contenido compartido. El hashtag debe incluir el símbolo de la almohadilla; p. ej., `#facebook`. El valor predeterminado es `null`.	No
`href`	Enlace para compartir. El valor predeterminado es la URL actual.	Obligatorio cuando usas el SDK.
~~`redirect_uri`~~ Obsoleto	~~URL a la que redirigir cuando una persona haga 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 del sitio web. Esta opción solo está disponible para dispositivos móviles, no para ordenadores.~~	~~`false`~~

Datos de respuesta

Solo se obtiene una respuesta si el usuario ha iniciado sesión en tu aplicación utilizando el inicio de sesión con Facebook.

Parámetro	Descripción
`error_message`	Mensaje de error.

Más información

Prácticas recomendadas para el contenido compartido