Aggiornamenti sui giochi tramite Messenger

Ai giochi istantanei di Facebook può essere associato un bot della piattaforma di Messenger. Nonostante sia facoltativa, tale operazione offre un potente canale per promuovere l'interazione. Ecco come creare e configurare il bot del tuo gioco:

Passaggio 1: crea una Pagina

Per creare un bot del gioco, devi prima creare una Pagina Facebook. Affinché la pagina funzioni correttamente con il tuo gioco istantaneo, è necessario soddisfare alcuni criteri specifici:

• La categoria della pagina deve essere Pagina dell'app (solo questa categoria)
• Il nome della pagina deve contenere il nome dell'app.
• La Pagina non può essere associata ad altre app.

Per creare una pagina con questi criteri, visita la dashboard gestione app e segui questi passaggi:

1. Nel menu Prodotto, espandi il menu a discesa Giochi istantanei e seleziona Dettagli
2. Nella pagina Dettagli, trova la sezione intitolata Pagina dell'app e clicca su Crea nuova pagina
3. Vai alla sezione Pagina dell'app del prodotto Giochi istantanei. Prima di procedere al passaggio successivo, assicurati che la tua sezione Pagina dell'app sia simile a quanto illustrato nel passaggio a destra:

Passaggio 2: attiva il tuo bot

Dopo aver creato la tua pagina, dovrai assicurarti di rispondere ai suoi webhook relativi ai messaggi. I Webhooks sono chiamate HTTP che inviamo al tuo back-end quando alla tua Pagina viene inviato u evento relativo ai messaggi. La logica del tuo server deciderà come rispondere correttamente a ciascun evento, se una risposta è opportuna. Per associare gli endpoint del tuo server agli eventi della tua pagina, segui le istruzioni del tutorial di avvio rapido per la Piattaforma Messenger per abilitare il bot per la tua pagina. La tabella qui sotto contiene informazioni relative ai webhook e alle autorizzazioni necessarie per il funzionamento del bot con i giochi istantanei:

Passaggio 3: rispondi ai webhook messaging_game_plays

Una volta configurato correttamente il tuo bot, la tua app server inizierà a ricevere webhook messaging_game_plays ogni volta che un giocatore chiude il gioco istantaneo. Di seguito è riportato un esempio di un'applicazione server che rileva e risponde a uno di questi webhook.

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!'
    );
  }
}

Per maggiori informazioni su questo webhook, fai riferimento alla documentazione sulla Piattaforma Messenger: documentazione sul webhook relativo all'utilizzo del gioco.

Passaggio 4: riporta i tuoi giocatori nel gioco

Ecco un esempio di come usare l'API Graph per inviare un pulsante game_play ai tuoi giocatori.

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>" } } ] } ] } } } }'

Per maggiori informazioni su questo pulsante, fai riferimento alla documentazione sulla Piattaforma Messenger: documentazione sul pulsante relativo all'utilizzo del gioco.

Passaggio 5: rispetta le nostre linee guida e normative

Prima del lancio in produzione, il tuo bot di gioco deve essere sottoposto al processo di invio alla Piattaforma Messenger. Assicurati di dare un'occhiata alla nostra Lista di controllo per i bot prima di inviarlo per l'analisi.