Atualizações de jogo via Messenger

Os jogos instantâneos do Facebook podem ter um bot da Plataforma do Messenger associado. Embora isso seja opcional, proporciona ao seu jogo um canal poderoso para reenvolvimento. Veja a seguir como criar e configurar o bot de seu jogo:

Etapa 1: Criar uma Página

Para criar um bot de jogo, primeiro é preciso criar uma Página do Facebook. Para que a página funcione corretamente com seu Jogo Instantâneo, é preciso que ele atenda a alguns critérios específicos:

• A categoria da página precisa ser Página de aplicativo (apenas essa categoria)
• O nome da página precisa conter o nome do aplicativo.
• A página não pode estar associada a outro aplicativo.

Para criar uma página com esses critérios, acesse seu Painel de Aplicativos e siga estas etapas:

1. No menu Produto, expanda o menu suspenso Jogos Instantâneos e selecione Detalhes
2. Na página Detalhes, encontre a seção com título Página do aplicativo e clique em Criar nova página
3. Acesse a seção Página de aplicativo do produto Jogos Instantâneos. Antes de passar para a próxima etapa, verifique se a seção Página de aplicativo está igual à etapa à direita:

Etapa 2: Ativar o bot

Depois de criar sua página, será preciso responder aos webhooks de mensagem. Webhooks são chamadas HTTP que enviamos ao seu backend quando um evento de mensagem é enviado à Página. A lógica de seu servidor decidirá, então, como responder corretamente a cada evento, se uma resposta for adequada. Para associar os pontos de extremidade do servidor aos eventos da Página, siga as instruções do Tutorial de início rápido da Plataforma do Messenger para ativar o bot de sua Página. A tabela abaixo contém informações sobre os webhooks e as permissões necessárias para que o bot funcione com os Jogos Instantâneos:

Etapa 3: Responder aos webhooks messaging_game_plays

Quando o bot estiver configurado corretamente, o aplicativo do servidor começará a receber webhooks messaging_game_plays sempre que um jogador fechar o Jogo Instantâneo. Veja abaixo um exemplo de um aplicativo de servidor detectando e respondendo a um desses webhooks.

if (event.game_play) {
  var senderId = event.sender.id; // Messenger sender id
  var playerId = event.game_play.player_id; // Instant Games player id
  var contextId = event.game_play.context_id; 
  var payload = event.game_play.payload;
  var playerWon = payload['playerWon'];
  if (playerWon) {
    sendMessage(
      senderId, 
      contextId, 
      'Congratulations on your victory!', 
      'Play Again'
    );

  } else {
    sendMessage(
      senderId, 
      contextId, 
      'Better luck next time!', 
      'Rematch!'
    );
  }
}

Consulte mais informações na documentação da Plataforma do Messenger sobre este webhook: Documentação do webhook de sessão de jogo

Etapa 4: Levar os jogadores de volta ao jogo

Veja abaixo um exemplo de como utilizar a Graph API para enviar um botão game_play a seus jogadores.

curl "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>" -X POST -H "Content-Type: application/json" -d '{ "messaging_type": "UPDATE", "recipient": { "id": "<RECIPIENT_ID>" }, "message": { "attachment": { "type": "template", "payload": { "template_type": "generic", "elements": [ { "title": "It has been a while since your last game. Time to get back", "buttons": [ { "type": "game_play", "title": "Play Tic-Tac-Toe.", "payload": "{}", "game_metadata": { "context_id": "<CONTEXT_ID>" } } ] } ] } } } }'

Consulte a documentação da Plataforma do Messenger para mais informações sobre esse botão: Documentação do botão de sessão de jogo

Etapa 5: Seguir nossas diretrizes e políticas

Antes de ser lançado para produção, o bot de seu jogo deverá passar pelo processo de envio para a Plataforma do Messenger. Veja nossa Lista de verificação do bot antes de enviá-lo para análise.