Cuadro de diálogo de contenido compartido

El cuadro de diálogo de contenido compartido permite a las personas publicar una historia individual en su biografía. En esta documentación se 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.

Si eres el administrador de web 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ámetroDescripció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

Retirado

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

Retirado

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ámetroDescripción

error_message

Mensaje de error.