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. Ele não requer o Login no Facebook ou qualquer outra permissão estendida, portanto é a maneira mais fácil de habilitar o compartilhamento na Web.

Se as pessoas estiverem em um navegador que não está conectado com um cookie, a lista suspensa para escolher o público do seu compartilhamento não será exibida. Isso também ocorre se o aplicativo utilizar o diálogo do feed em vez do diálogo de compartilhamento ou se ele utilizar a visualização da web iframe.

Para implementar o diálogo de compartilhamento em aplicativos móveis nativos, leia nossos guias para iOS e Android.

Integração

O Diálogo de compartilhamento está disponível no SDK do Facebook para JavaScript. Para acionar o Diálogo de compartilhamento, você pode usar o trecho de código a seguir. Você pode usar também o direcionamento para uma URL. Para saber mais, consulte Tópicos avançados.

SDK do Facebook para JavaScript

Dispare o Diálogo de compartilhamento usando a função FB.ui com o parâmetro do método share para compartilhar um link.

Para compartilhar um link:

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

Inclua metatags do Open Graph na página nessa URL para personalizar a história que é compartilhada de volta no Facebook.

Observe que response.error_message só será exibido se alguém que estiver usando seu aplicativo tiver autenticado seu aplicativo com o Login no Facebook.

Parâmetros

Parâmetros comuns

O JS SDK fornecerá esses parâmetros automaticamente.

ParâmetroDescrição

app_id

O identificador exclusivo do seu aplicativo. Obrigatório.

redirect_uri

A URL de redirecionamento depois que a pessoa clica em um botão no diálogo. Obrigatório ao usar o redirecionamento da URL.

display

Determina a forma de renderização do diálogo.

  • Se estiver usando a implementação do diálogo do redirecionamento de URL, ela será representada por uma exibição de página inteira, mostrada no Facebook.com. Chamamos esse tipo de exibição de page.
  • Se você estiver usando um de nossos SDKs para iOS ou Android para invocar o diálogo, ele será automaticamente especificado e selecionará um tipo de exibição adequado para o dispositivo.
  • Se você estiver usando o SDK do Facebook para JavaScript, o padrão será um tipo de iframe modal para pessoas conectadas ao seu aplicativo ou async ao usar em um jogo no Facebook.com, e uma janela popup para todos os outros casos. Você também pode forçar o tipo popup ao usar o SDK do Facebook para JavaScript, se necessário.
  • Aplicativos da Web para dispositivos móveis sempre terão o tipo de exibição touch como padrão.

Parâmetros share

ParâmetroDescriçãoPadrão

href

O link anexado a essa publicação. Obrigatório ao usar o método share. Inclua metatags do Open Graph na página nessa URL para personalizar a história compartilhada.

URL atual

hashtag

Uma hashtag especificada pelo desenvolvedor a ser adicionada ao conteúdo compartilhado. As pessoas ainda poderão remover essa hashtag no diálogo. A hashtag deve incluir o símbolo de jogo da velha, por exemplo, #facebook.

null

quote

Uma citação a ser compartilhada com o link, destacada pelo usuário ou predefinida pelo desenvolvedor, como em uma citação em um artigo.
Este parâmetro não está disponível para URLs do Facebook.

null

mobile_iframe

Se configurado como true, o botão Compartilhar abrirá o diálogo de compartilhamento em um iframe na parte superior do seu site. Confira mais informações em Diálogo de compartilhamento da Web móvel. Essa opção só está disponível para dispositivos móveis, não para desktops.

false


Response Data

Parâmetro Descrição

post_id

Disponível apenas se o usuário estiver conectado ao seu aplicativo usando o Facebook e tiver concedido publish_actions. Se presente, esse é o ID da publicação de Open Graph.

error_message

Disponível apenas se o usuário estiver conectado ao seu aplicativo usando o Login no Facebook.

Tópicos avançados

Você também pode aproveitar os recursos avançados a seguir.

Diálogo de compartilhamento da Web móvel

O diálogo de compartilhamento da Web móvel também pode ser mostrado em um iFrame na parte superior do seu conteúdo. Se uma pessoa concluir o fluxo de compartilhamento, o diálogo será dispensado e ela terá novamente o conteúdo original para que possa continuar a consumi-lo.

Exemplo de código

Para habilitar o diálogo de compartilhamento da Web móvel em um iframe, configure o atributo mobile_iframe como true:

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

Redirecionamento de URL

Para compartilhar um link:

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

Observação: ao testar esse código, remova as quebras de linha. Do contrário, será gerado um erro.

Ações de Open Graph

Acione um Diálogo de compartilhamento usando a função FB.ui com o parâmetro do método share_open_graph para compartilhar uma publicação de Open Graph.

Para compartilhar uma publicação de Open Graph com o diálogo:

FB.ui({
  method: 'share_open_graph',
  action_type: 'og.likes',
  action_properties: JSON.stringify({
    object:'https://developers.facebook.com/docs/',
  })
}, function(response){});

Observe que o redirecionamento da URL funciona da mesma forma que os compartilhamentos de links padrão.

Parâmetros share_open_graph

Use os mesmos parâmetros usados para compartilhar um link padrão, mas adicione o seguinte:

Parâmetro Descrição

action_type

Uma cadeia de caracteres especificando qual tipo de ação de Open Graph deve ser publicada, por exemplo, og.likes para o tipo de curtida integrada. O diálogo também suporta os tipos personalizados aprovados. Obrigatório ao usar o método share_open_graph.

action_properties

Um objeto JSON dos pares chave/valor especificando os parâmetros que correspondem ao action_type que está sendo usado. Pares chave/valor válidos são os mesmos parâmetros que podem ser usados ao publicar Ações do Open Graph usando a API. Obrigatório ao usar o método share_open_graph.

O diálogo share_open_graph não é compatível com mobile_iframe: true.