Ersetzen Sie benutzerdefinierte Integrationen durch Webhooks. Hierzu müssen Sie lediglich eine URL konfigurieren und die aufkommenden Ereignisse beobachten. Befolgen Sie einfach die folgende Schritte, um diese Funktion zu testen.
Noch keinen MoreApp-Account? Hier anmelden!
Diese Funktion ist im Zweig-, Baum- und Waldplan verfügbar. Klicken Sie hier und erfahren Sie mehr über unsere Pläne.
Webhooks sind Integrationen, welche durch ein bestimmtes Ereignis ausgelöst werden und bestimmte Daten versenden. In diesen Nachrichten sind nützliche Informationen enthalten, welche an eine URL gesendet werden und nachdem sie empfangen wurden, eine neue Aktion ausführen. Dies gestattet eine Verknüpfung von MoreApp mit jeder anderen Software!
1. Webhook hinzufügen
Wenn Sie die Berechtigung haben Webhooks zu erstellen, dann wählen Sie unter der Registerkarte Einstellungen das Tab für Webhooks aus. Klicken Sie nun auf Hinzufügen, um einen neuen Webhook hinzuzufügen.
Hinweis:
- Es gibt ein Limit von 100 Webhooks pro Account.
- Wenn Sie mehrere Webhooks haben, besteht die Möglichkeit, sie vom gleichen Ereignis in Ihrer App auszulösen. Sie können ihre URLs in einer einzigen URL kombinieren. Hier erfahren Sie, wie Sie mehrere Zaps mit Webhooks auslösen können.
2. Webhook-Konfiguration
Geben Sie dem Webhook unter Name einen bezeichnenden Namen und fügen Sie die entsprechende URL hinzu, an welche Ihre MoreApp-Daten übermittelt werden sollen.
Hinweis: Die betreffende URL muss mithilfe einer Integration oder einer Integrationsplattform wie z.B. Zapier generiert werden.
Nachdem Sie die korrekte URL hinterlegt haben, müssen Sie unter Ereignistypen den Typ des Ereignisses auswählen, bei welchem Ihre MoreApp-Daten an die URL versendet werden sollen. Wählen Sie beispielsweise ‘submission.created’, um festzulegen, dass der Webhook im Anschluss auf jede eingesendete Submission ausgelöst werden soll.
Aktuell lassen sich folgende Ereignisse unter Ereignistypen wählen:
Ereignistyp | Definition/Erklärung |
|---|---|
submission.created | Ein Formular wird als Submission gesendet. |
submission.pipeline.created | Bearbeitungsbeginn eines Formulars als Submission |
submission.pipeline.blocked | Die Einreichung eines Formulars wurde aufgrund eines Fehlers unterbrochen und nicht automatisch wiederholt. |
submission.pipeline.failed | Die Einreichung eines Formulars wurde aufgrund eines Fehlers unterbrochen und automatisch wiederholt. |
submission.pipeline.succeeded | Ein Formular wurde erfolgreich als Submission eingereicht. |
submission.pipeline.mail.sent | Durch die Einreichung der Submission wurde eine E-Mail versendet. |
submission.instruction.created | Es wurde eine Arbeitsanweisung an einen Nutzer versendet. |
submission.instruction.fulfilled | Eine Arbeitsanweisung wurde von einem Nutzer ausgeführt. |
Sobald Sie fertig sind, klicken Sie auf Speichern, um alles zu sichern.
3. Testlauf durchführen
Nun können Sie die Funktionalität Ihres Webhooks testen!
Reichen Sie hierfür eines Ihrer MoreApp-Formulare ausgefüllt als Submission ein. Dieser Schritt ist erforderlich, um den Webhook über die generierten Daten zu informieren.
Weitere Informationen zur Konfiguration von Webhooks finden Sie in Englischer Sprache unter Developer Docs.
Hinweise:
- Jede API, die nicht in unserer API-Dokumentation vermerkt ist, kann jederzeit geändert werden.
- Berücksichtigen Sie, dass das Datumsformat, das Sie über Webhooks erhalten, JJJJ-MM-TT ist.
- Die URL sollte einen HTTP POST Request mit einem JSON Body akzeptieren und einen HTTP 200 OK Statuscode zurückgeben.
- Stellen Sie sicher, dass mindestens 1 von 50 Anfragen erfolgreich zurückkommt. MoreApp deaktiviert automatisch einen Nutzer, sobald 50 aufeinanderfolgende Ausfälle aufgetreten sind.
Möchten Sie als Erster unsere neuesten Tutorials erhalten? Besuchen Sie uns auf YouTube und abonnieren Sie unseren MoreApp-Kanal.