Actualités de jeu via Messenger

Il est possible d’associer un bot de plate-forme Messenger aux Jeux instantanés Facebook. Même si cela est facultatif, votre jeu bénéficie d’un moyen efficace de relancer l’audience. Voici comment créer et configurer le bot de votre jeu :

Étape 1 : Créer une Page

Pour créer un bot de jeu, vous devez d’abord créer une Page Facebook. Pour que la Page fonctionne correctement avec votre Jeu instantané, elle doit répondre à quelques critères spécifiques :

• Elle doit uniquement appartenir à la catégorie Page d'application.
• Son nom doit contenir celui de l’app.
• Elle ne peut pas être associée à une autre app.

Pour créer une page avec ces critères, consultez votre Espace App et procédez comme suit :

1. Dans le menu Produit, développez la liste Jeux instantanés et sélectionnez Détails.
2. Dans la page Détails, accédez à la section Page de l’app, puis cliquez sur Créer une page.
3. Accédez à la section Page de l’app du produit Jeux instantanés. Avant de passer à l’étape suivante, assurez-vous que votre section Page de l’app est conforme à l’étape indiquée à droite :

Étape 2 : activer votre bot

Après avoir créé votre Page, assurez-vous de répondre à ses webhooks de messagerie. Les webhooks sont des appels HTTP que nous envoyons à votre serveur backend lorsqu’un évènement de messagerie est envoyé à votre Page. La logique de votre serveur décide par la suite comment répondre correctement à chaque évènement, si une réponse est appropriée. Pour associer les points de terminaison du serveur aux évènements de votre Page, suivez les instructions du didacticiel relatif au démarrage rapide de la plate-forme Messenger afin d’activer le bot pour votre Page. Le tableau ci-dessous contient des informations sur les webhooks et les autorisations dont vous aurez besoin pour que votre bot fonctionne avec les Jeux instantanés :

Étape 3 : répondre aux webhooks messaging_game_plays

Une fois que votre bot est correctement configuré, votre application de serveur reçoit des webhooks messaging_game_plays chaque fois qu'un joueur ferme le Jeu instantané. Vous trouverez ci-dessous un exemple d’application de serveur qui détecte l’un de ces webhooks et y répond.

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

Consultez la documentation relative à la plate-forme Messenger pour en savoir plus sur ce webhook : Documentation sur le webhook « Game Play »

Étape 4 : attirer de nouveau les joueurs vers le jeu

L’exemple ci-dessous illustre comment utiliser l’API Graph pour envoyer un bouton game_play à vos joueurs.

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

Consultez la documentation relative à la plate-forme Messenger pour en savoir plus sur ce bouton : Documentation sur le bouton « Game Play »

Étape 5 : suivre nos règles et nos règlements

Avant d’être mis en production, le bot de votre jeu doit passer par un processus de soumission à la plate-forme Messenger. Pensez à consulter notre Liste de contrôle du bot avant de l’envoyer pour certification.