Meta-Webhooks

Beispiel-Apps

Wir stellen Beispiel-Apps auf GitHub zur Verfügung, die du einrichten und wiederverwenden kannst oder zum schnellen Testen deiner Webhooks-Konfiguration nutzen kannst.

Einrichten der Beispiel-App

Gehen wir gemeinsam die Einrichtung einer Beispiel-App auf Heroku durch:

  1. Erstelle ein kostenloses Heroku-Konto, wenn du noch keines hast, und melde dich dann bei Heruko an.
  2. Wenn du angemeldet ist, navigierst du zu GitHub und stellst die App auf Heroku bereit. Der von dir ausgewählte App-Name wird in deiner Rückruf-URL verwendet. Verwende also einen Namen, den du dir gut merken kannst. Die Bereitstellung dauert einen Moment.
  3. Navigiere in einem neuen Browser-Tab zu den Einstellungen des App Dashboards und kopiere den App-Geheimcode deiner App.
  4. Richte in den Einstellungen deiner Heroku-App zwei Config Vars ein: APP_SECRET und TOKEN. Weise deinen App-Geheimcode der Config Var APP_SECRET zu (durch Einfügen) und weise TOKEN einen beliebigen String zu. Wir fügen diesen String in alle Verifizierungsanfragen ein, wenn du das Webhooks-Produkt im App-Dashboard konfigurierst (die App validiert die Anfrage selbst).

Deine App sollte nun fertig ist. Bevor du zu deinem App-Dashboard zurückkehrst, um das Webhooks-Produkt zu konfigurieren, tue Folgendes:

  • Zeige deine Heruko-App in einem Web-Browser an. Du solltest ein leeres Array ([]) sehen. Diese Seite zeigt neu eingegangene Update-Meldungen an. Lade sie daher während der Tests immer wieder neu.
  • Die Rückruf-URL deiner App ist die URL deiner Heroku-App, an deren Ende /facebook angefügt ist. Du benötigst diese Rückruf-URL bei der Produktkonfiguration.
  • Kopiere den TOKEN-Wert, den du oben festgelegt hast. Du brauchst ihn auch bei der Produktkonfiguration.

Was ist in der Heruko-Beispiel-App enthalten?

Die App verwendet Node.js und diese Pakete:

  • body-parser (zum Parsen von JSON)
  • express (für Routen)
  • express-x-hub (für SHA1-Unterstützung)

Verifizieren der Beispiel-App

Du kannst auf einfache Weise bestätigen, dass deine Beispiel-App Webhook-Events empfangen kann.

  1. Klicke in deinem App-Dashboard unter dem Produkt Webhooks bei einem der Webhook-Felder auf den Button Test.
  2. Ein Popup-Dialogfeld zeigt ein Beispiel dafür, was gesendet wird. Klicke auf Send to My Server.
  3. Du solltest jetzt die Webhook-Informationen unter der URL der Heroku-App sehen. Du kannst aber auch curl https://<your-subdomain>.herokuapp.com in einem Terminal-Fenster verwenden.