Compartilhamento

Compartilhamento para Dispositivos

Este ponto de extremidade se tornou obsoleto no dia 2 de novembro de 2020.

Com o Compartilhamento para Dispositivos, as pessoas podem compartilhar facilmente conteúdo de dispositivos no Facebook. Isso inclui smart TVs, porta-retratos digitais ou dispositivos IoT.

Ao usar o recurso, o dispositivo exibirá um código alfanumérico que precisa ser inserido em uma página da web no desktop ou no smartphone. As pessoas que usam o seu aplicativo ou serviço podem compartilhar conteúdo no Facebook a partir de um diálogo de compartilhamento associado ao código.

Se você estiver criando um aplicativo para Apple TV ou dispositivos Android, use o SDK para tvOS ou o SDK para Android, respectivamente.

Este guia descreve o seguinte:

Experiência do usuário

1. Chamada para ação

Primeiro, avalie em que ponto da experiência do usuário você quer pedir para as pessoas compartilharem conteúdo no Facebook. Para garantir a melhor experiência, projete o botão para se parecer o máximo possível com o botão Compartilhar do Facebook. Em geral, o botão deve estar próximo ao conteúdo a ser compartilhado.

Na perspectiva do design visual, isso significa o seguinte:

  1. Identifique o botão com a etiqueta "Compartilhar" ou "Compartilhar no Facebook".
  2. Use a cor branca e o azul oficial da marca Facebook (#3B5998).
  3. Incorpore o logotipo oficial "f" se o dispositivo for compatível com visualização gráfica (opcional). O logotipo também deve ser branco ou azul Facebook (# 3B5998), de acordo com as diretrizes da marca do Facebook.

2. Exibição do código

Quando alguém clicar na chamada para ação, o dispositivo fará uma chamada para a API do Facebook, que retornará um código.

Na sua interface, oriente as pessoas a visitar um site e inserir o código por meio da seguinte mensagem: "Agora, acesse facebook.com/device (http://facebook.com/device) no seu desktop ou smartphone e insira este código". O código completo recebido pela API de Compartilhamento para Dispositivos será exibido. Ele tem de 6 a 12 caracteres.

Inclua um botão Close ou Done para que as pessoas possam concluir o fluxo do recurso Compartilhamento para Dispositivos.

3. Compartilhamento

Este é o fluxo visto pelos usuários ao acessar facebook.com/device no navegador para desktop ou celular. Primeiro, eles veem um campo de texto em que podem inserir o código:

Depois de inserir o código e clicar em Continue, eles veem um diálogo de compartilhamento:

Por fim, as pessoas recebem uma mensagem de confirmação para saber que o compartilhamento foi concluído:

Implementação do Compartilhamento para Dispositivos

O recurso está disponível para dispositivos que podem fazer chamadas HTTP pela internet. As chamadas de API e as respostas do dispositivo estão descritas a seguir.

1. Ativar o login para dispositivos

Abra o painel do aplicativo. Acesse Configurações > Avançado > Configurações OAuth e mude a opção Login de dispositivos para "Sim".

2. Gerar um código

Quando o usuário clicar na chamada para ação Share, o seu dispositivo deverá fazer uma solicitação HTTP POST para:

POST https://graph.facebook.com/device/share
       access_token=<APPID|CLIENT_TOKEN>
       href=<LINK_TO_SHARE>

Para encontrar o CLIENT_TOKEN, acesse Configurações do aplicativo > Avançado. Ele deve ser combinado com o ID do aplicativo (separado por uma barra vertical, |) para formar o access_token completo.

A API também é compatível com action_type e action_properties, em vez de href, se você quiser compartilhar uma publicação de Open Graph (assim como ações de Open Graph no diálogo de compartilhamento).

Além disso, a API é compatível com os parâmetros quote e hashtag (assim como os parâmetros do diálogo de compartilhamento).

A resposta estará no seguinte formato:

{
  "user_code": "A1NWZ9",
  "verification_uri": "https://www.facebook.com/device",
  "expires_in": 420,
}

A resposta significa o seguinte:

  1. A string "A1NWZ9" será exibida no seu dispositivo.
  2. A pessoa será orientada a acessar "facebook.com/device" e inserir esse código.
  3. O código expirará em 420 segundos. A exibição do código deverá ser fechada após esse período.

3. Exibição do código

O dispositivo deve exibir o user_code e orientar as pessoas a visitar a verification_uri (como facebook.com/device) no desktop ou no smartphone. Consulte Experiência do usuário.

Solução de problemas

Posso fazer solicitações de fluxo do dispositivo por meio de HTTP?
A Graph API com tokens exige TLS/HTTPS.

Posso fazer solicitações de fluxo do dispositivo pelo método GET?
Todas as solicitações de fluxo do dispositivo devem ser POST.

Posso saber quando a pessoa concluiu um compartilhamento?
Não.

Posso publicar em nome da pessoa de forma programática?
Não. Para fazer isso, é preciso solicitar que o usuário entre na conta e conceda permissões para você publicar em nome dele. Veja como publicar com a Graph API para saber mais.