Diálogo de compartilhamento

O diálogo de compartilhamento permite que as pessoas publiquem uma história individual na própria linha do tempo, na linha do tempo de um amigo, em um grupo ou em uma mensagem privada no Messenger. Para usar o recurso, não é preciso ter o Login do Facebook nem permissões estendidas. Por isso, essa é a maneira mais fácil de habilitar o compartilhamento na web.

Esta documentação descreve como implementar o diálogo de compartilhamento na web. Para implementar o diálogo de compartilhamento em um app para celular, consulte os guias para iOs e Android.

Veja a seguir um exemplo de diálogo de compartilhamento que publica um link na linha do tempo de um usuário.

Na imagem anterior, a opção Compartilhar em sua própria linha do tempo é selecionada na lista suspensa para escolher o público para o compartilhamento. Essa lista não é exibida quando uma pessoa usa um navegador que não está conectado com um cookie. Isso também acontece quando o app usa o diálogo do feed, e não o de compartilhamento, ou quando é usada a visualização da web de iframe.

Se você for o webmaster de uma página compartilhada no Facebook, inclua metatags do Open Graph para personalizar a história que é compartilhada na plataforma. É importante marcar o site com tags do Open Graph para controlar como seu conteúdo é exibido no Facebook. Para saber mais, consulte Um guia de compartilhamento para webmasters.

Compartilhar usando o redirecionamento de URL

Para compartilhar um link usando o redirecionamento de URL, use o código a seguir. Incluímos quebras de linha para facilitar a leitura. Remova-as quando usar 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

Compartilhar usando o SDK do Facebook para JavaScript

O diálogo de compartilhamento é disponibilizado no SDK do Facebook para JavaScript quando você usa a função FB.ui com o parâmetro do método share. Use o trecho de código a seguir para abrir o diálogo de compartilhamento.

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

Experimente!

Parâmetros

Veja a seguir os parâmetros do diálogo de compartilhamento.

Parâmetro	Descrição	Obrigatório?
`app_id`	O identificador único do app.	Sim. Fornecido automaticamente quando você usa o SDK.
`display`	Define como o diálogo de compartilhamento é renderizado. Redirecionamento de URL – O valor de `display` é `page`. O diálogo de compartilhamento é uma página inteira que aparece no site Facebook.com. SDK do Facebook para JavaScript – O valor de exibição é um dos seguintes: Um `iframe` modal para pessoas que entraram no seu app `async` quando incluído em um jogo no site Facebook.com Uma janela `popup` para todos os outros Se for necessário, é possível forçar o tipo `popup` ao usar o SDK do Facebook para JavaScript. Apps de web móvel – O valor de `display` é sempre `touch`. SDK do Facebook para iOS ou Android – O SDK especifica `display` automaticamente e escolhe um tipo de exibição apropriado para o dispositivo.	Sim. Fornecido automaticamente quando você usa o SDK.
`hashtag`	Representa uma hashtag para adicionar ao conteúdo compartilhado. As pessoas podem remover a hashtag no diálogo de compartilhamento. A hashtag deve incluir o símbolo de hash, por exemplo `#facebook`. O valor-padrão é `null`.	Não.
`href`	Representa o link para compartilhar. O valor-padrão é a URL atual.	É necessário quando você usa o SDK.
~~`redirect_uri`~~ Obsoleto	~~Representa a URL para a qual uma pessoa será redirecionada depois de clicar em um botão no diálogo de compartilhamento.~~	~~Sim. Fornecido automaticamente quando você usa o SDK.~~
~~`mobile_iframe`~~ Obsoleto	~~`true` para abrir o diálogo de compartilhamento em um iframe na parte superior do seu site. Esta opção está disponível apenas para dispositivos móveis, não para desktop.~~	~~`false`~~

Dados de resposta

Haverá uma resposta somente se o usuário tiver entrado no seu app usando o Login do Facebook.

Parâmetro	Descrição
`error_message`	Representa uma mensagem de erro.

Veja também

Boas práticas