Webhooks Meta

Échantillons d’applications

Nous fournissons des échantillons d’applications sur GitHub que vous pouvez configurer et réutiliser, ou pour tester rapidement vos Webhooks.

Configurer l’échantillon d’application

Passons en revue la procédure de configuration d’un échantillon d’application sur Heroku :

  1. Créez un compte Heroku gratuit si vous n’en avez pas déjà un, puis connectez-vous.
  2. Une fois connecté, accédez à GitHub et déployez l’application dans Heroku. Le nom de l’application fera partie de votre URL de rappel, donc choisissez-le de manière à pouvoir vous en souvenir. Le déploiement prendra quelques secondes.
  3. Dans un nouvel onglet du navigateur, accédez aux paramètres de l’Espace App de votre application et copiez la clé secrète.
  4. Dans les paramètres de votre application Heroku, configurez deux variables de configuration : APP_SECRET et TOKEN. Affectez (collez) votre clé secrète à la variable de configuration APP_SECRET et une chaîne à TOKEN. Nous inclurons cette chaîne dans toute demande de vérification lorsque vous configurerez le produit Webhooks dans l’Espace App (l’application validera elle-même la demande).

Votre application devrait maintenant être prête. Avant de revenir à votre Espace App pour configurer le produit Webhooks :

  • Visualisez votre application Heroku dans un navigateur web. Vous devriez voir une grille vide ([]). Cette page affichera les données de notification de mise à jour récemment reçues, il faut donc la recharger tout au long des tests.
  • L’URL de rappel de votre application sera l’URL de votre application Heroku suivie de /facebook. Vous aurez besoin de cette URL de rappel pendant la configuration du produit.
  • Copiez la valeur TOKEN que vous avez définie ci-dessus ; vous en aurez également besoin lors de la configuration du produit.

Que contient l’échantillon d’application Heroku ?

L’application utilise Node.js et les packages suivants :

  • body-parser (pour l’analyse JSON)
  • express (pour le routage)
  • express-x-hub (pour la compatibilité SHA1)

Vérification de l’échantillon d’application

Vous pouvez facilement vérifier que votre échantillon d’application peut recevoir des évènements Webhook.

  1. Sous le produit Webhooks dans votre Espace App, cliquez sur le bouton Test de l’un des champs Webhook.
  2. Une boîte de dialogue contextuelle affiche un échantillon de ce qui sera envoyé. Cliquez sur Send to My Server.
  3. Vous devriez maintenant voir les informations du Webhook dans l’URL de l’application Heroku, ou utilisez curl https://<your-subdomain>.herokuapp.com dans une fenêtre de terminal.