Webhook
Das ist der Ausgang für die Kanäle mit eingeschaltetem Per Webhook übergeben: wohin ihre Beiträge übergeben werden und wie alles, was sie empfängt, belegt, dass sie von Reelwire kamen. Sie finden es unter Verbindungen, dann Webhook; früher hieß es Veröffentlichung. Was jede Übergabe gesendet hat, per E-Mail, per Webhook und per Plattform-Connector, steht unter Aktivität, unter Versendeter Inhalt. Es braucht die Berechtigung Verwaltung, die auch zum Speichern der Adresse, für Zustellung testen und Erneut zustellen nötig ist, und es ist absichtlich getrennt von den API-Schlüsseln. Ein Schlüssel kommt in das Skript, das Daten hineinschickt. Was auf dieser Seite steht, kommt in das, was hinausgehende Beiträge empfängt. Beides wird zu unterschiedlichen Zeiten von unterschiedlichen Personen eingerichtet.
Wenn ein Beitrag fällig ist, wird er übergeben, per E-Mail, per Webhook oder beides, wie es jeder Kanal unter Kanäle festlegt, und wer ihn empfängt, postet ihn: Ihr eigenes Skript, eine Automatisierung oder ein Posting-Dienst hinter dem Webhook oder eine Person, die die E-Mail liest. Ein Kanal, der nur per E-Mail übergeben wird, braucht auf dieser Seite nichts, und seine E-Mails stehen trotzdem unter Versendeter Inhalt in der Aktivität. Das gilt auch für die Beiträge, die der Plattform-Connector eines Kanals gemacht hat, dessen Zugangsdaten am Kanal selbst festgelegt werden.
Das Kapitel Anleitungen hat eine Anleitung für jede Art von Empfänger: Per Webhook übergeben.
Ihre Webhook-Adresse
Die Karte Webhook-Adresse festlegen legt die eine Adresse fest, an die alle Webhook-Aufrufe des Workspaces gehen, und zeigt, wie ein Empfänger belegt, dass sie von Reelwire kamen. Geben Sie sie in Webhook-Adresse ein (eine https-Adresse, bis zu 2.048 Zeichen) und klicken Sie auf Speichern. Jede Art von Aufruf geht dorthin: ein Beitrag zur Übergabe, eine Änderung daran, eine Bitte, einen zu entfernen, und ein Test. Ein Beitrag, der an mehrere Kanäle mit eingeschaltetem Per Webhook übergeben geht, kommt als ein signierter Aufruf an, der jeden Kanal des Stapels trägt. Webhooks beschreibt, was ein Aufruf enthält, wie man ihn beantwortet und wie man zurückmeldet, sobald ein Beitrag online ist.
Das Signatur-Secret ist alles, was ein Empfänger braucht: Jeder Workspace hat sein eigenes, sodass eine Zustellung, die damit verifiziert wird, von diesem Workspace stammt. Wie man es prüft, Header für Header, steht unter Webhooks.
Zustellung testen, neben Speichern, sendet jetzt einen signierten Testaufruf an die gespeicherte Adresse und sagt, was zurückkam, in einem grünen Feld („Zugestellt: Der Empfänger antwortete mit 200 in 184 ms“) oder einem roten („Nicht zugestellt.“ und warum; wo der Empfänger die Signatur abgelehnt hat, ein Hinweis, dass er das aktuelle Secret dieses Workspaces braucht). Er kommt genau so an wie eine echte Übergabe, über keinen Beitrag, sodass die Signaturprüfung eines Empfängers ausprobiert werden kann, bevor ein echter Beitrag ihn erreicht. Er wird angeboten, sobald die Adresse gespeichert ist, nicht solange das Feld eine nicht gespeicherte Änderung enthält, und jeder Test ist eine Zeile unter Versendeter Inhalt in der Aktivität. Seine Antwort verschwindet, sobald die Adresse geändert oder das Secret erneuert wird, da sie sich auf die alten bezog.
Das Signatur-Secret liegt in einem eigenen Bereich und zeigt nur seinen Anfang und sein Ende. Darunter sitzen zwei Schaltflächen. Secret kopieren fragt nach dem Passwort, mit dem Sie sich anmelden, und zeigt bei Secret anzeigen das ganze Secret mit Kopieren, wie das Kopieren eines API-Schlüssels: Falsche Passwörter zählen zum selben Limit wie die Anmeldung, und jedes Anzeigen wird im Audit-Protokoll des Workspaces festgehalten. Secret erneuern öffnet einen Dialog, der sagt, was das Erneuern kaputt macht, bevor etwas geschieht, und Jetzt erneuern lässt Reelwire das neue Secret erzeugen. Es öffnet sich dann in einem eigenen Dialog, Ihr neues Signatur-Secret, mit Kopieren; Ich habe es gespeichert schließt ihn, und Secret kopieren zeigt es später wieder an. Es gilt ab dem nächsten Aufruf: Alles, was noch mit dem alten Secret verifiziert, lehnt ab, bis Sie es aktualisieren, erneuern Sie es also erst, wenn Sie das neue Secret ausrollen können. Nur eine angemeldete Person kann das Secret anzeigen oder erneuern: kein API-Schlüssel kann es, weil beide es herausgeben.
Code abrufen
Die Karte Code abrufen unter der Webhook-Karte ist ein funktionierender Empfänger zum Kopieren in Ihr eigenes System, in Node.js, Python, PHP oder C#: Wählen Sie die Sprache über dem Code. Er prüft die Signatur jedes Aufrufs mit Ihrem Signatur-Secret, lehnt einen Aufruf ab, der älter als fünf Minuten ist, überspringt eine Wiederholung einer Zustellung, die er schon verarbeitet hat, und meldet für jeden Kanal einer Übergabe den Beitrag zurück, sobald Sie ihn gepostet haben, was ihn auf Beiträge von Übergeben auf Veröffentlicht setzt. Zwei Werte stehen für Ihre Geheimnisse: YOUR_SIGNING_SECRET, das Secret oben (Secret kopieren zeigt es), und YOUR_API_KEY, ein Schlüssel mit der Berechtigung Beiträge: schreiben aus den API-Schlüsseln. Die Meldung geht an die eigene Adresse dieses Reelwire, der Code funktioniert also so, wie er ist.