Webhooks
Ein eingehender Webhook ist eine Adresse, an die ein anderes System JSON postet. Jeder Webhook gehört zu einem Formular: Eine ankommende Payload wird zu einer Einsendung dieses Formulars für die Person, die die Payload nennt, und diese Einsendung kann eine Automation auslösen. Webhooks werden auf dem Formular erstellt, in seinem Seitenpanel Webhook; Settings listet sie alle an einem Ort.

Wie ein Webhook funktioniert
Abschnitt betitelt „Wie ein Webhook funktioniert“- Der Endpunkt ist
POST /api/webhook/<webhook id>mit dem HeaderAuthorization: Bearer <secret>und einem JSON-Body. Das Panel zeigt die URL und den Header, die zu senden sind: „Post a JSON body here, with the secret as a bearer token.“ - Der Body nennt die Person mit
subject_idund die Antworten unterfields. Die Einstellung Subject des Formulars sagt, aus welchem Quellsystem diese ID stammt, zum Beispiel eine BambooHR-Mitarbeitenden-ID. - Jeder Aufruf wird mit
202beantwortet, sobald er angenommen ist; der Tab History ist die Aufzeichnung dessen, was aus jeder Payload wurde. Einträge haben einen Code wiesubmitted,unknown-subject,missing-fields,invalid-fields,ambiguous-fieldsoderalready-submitted. - Sende einen Header
Idempotency-Key, um Wiederholungen sicher zu machen: Eine Wiederholung mit demselben Schlüssel wird erneut mit202beantwortet, aber nicht ein zweites Mal verarbeitet. - Eine Payload, die Pyn nicht annehmen konnte, erzeugt eine Benachrichtigung in Notices; ein Aufrufer, der denselben Fehler wiederholt, aktualisiert eine einzige Benachrichtigung, statt viele zu erzeugen. Admins können auch per E-Mail informiert werden; siehe Benachrichtigungs-E-Mails festlegen.
- Ein Webhook nimmt nichts an, bis er ein Secret hat, und ein archivierter Webhook nimmt keine Payloads mehr an.
Was du hier tun kannst
Abschnitt betitelt „Was du hier tun kannst“- Ein Webhook-Secret erstellen oder ersetzen
- Einen Webhook aus seinem Panel umbenennen: Bearbeite den Title und drücke Enter oder klicke woanders hin, um zu speichern
- Die History der Payloads lesen und das ganze Protokoll als CSV aus dem Webhook-Seitenpanel des Formulars exportieren
- Einen Webhook aus seinem …-Menü archivieren
Wo es in der App ist
Abschnitt betitelt „Wo es in der App ist“Öffne /settings/general/webhooks in Pyn, oder öffne Settings in der Hauptnavigation und wähle Webhooks unter General. Um einen Webhook zu erstellen, öffne das Formular in Forms, wähle Settings in der Leiste und dann Add Webhook.
Verwandte Seiten
Abschnitt betitelt „Verwandte Seiten“- Ein Webhook-Secret erstellen oder ersetzen vor der ersten Payload.
- Forms, um den Webhook zu erstellen und sein Subject zu wählen.
- Notices für Payloads, die Pyn nicht annehmen konnte.