Cuadro de diálogo de contenido compartido

El cuadro de diálogo de contenido compartido brinda a las personas la posibilidad de publicar una historia individual en la biografía. 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 enlace a la biografía de un usuario.

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

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

error_message

Un mensaje de error.