Was wird mit dem Webhook empfangen?

Erfahren Sie, wie das JSON strukturiert ist, das der Webhook übermittelt.

1. Der Header der Daten

{
  "id": "171216479",
  "eventType": "finished",

• id : Die eindeutige Kennung der Daten.
• eventType : Die Aktion, die den Versand des Webhooks ausgelöst hat. Es gibt fünf mögliche Typen :
  • finished : Die Daten wurden gespeichert.
  • update : Die Daten wurden geändert.
  • push : Die Daten wurden übertragen.
  • pull : Die Daten wurden auf dem Mobilgerät des Empfängers empfangen.
  • delete : Die Daten wurden über die Web-Oberfläche gelöscht.

2. Der Schlüssel data

Im Schlüssel data befinden sich die informationen zum Datenereignis.

  "data": {
    "recipient_user_id": null,
    "answer_time": "2023-09-18T17:17:39+02:00",
    "update_answer_time": "2023-09-18T17:17:39+02:00",
    "id_tel": "0e7cf0a8-46bc-4246-a7ec-bbfd552cfa91",
    "media": [
      "c55318f923838pu319057_20230918171436_7a49b140.jpg",
      "c55318f923838pu319057_20230918171617_5f3a8c56-85ff.jpg",
      "c55318f923838su319057_20230918171701_b8518e6a.png"
    ],
    "form_id": "923838",
    "origin": "android",
    "app_version": "7.19.198",
    "device_info": "SM-G986B android(33)",
    "form_update_time": "2023-09-19 10:10:20",
    "local_uuid": "c2f42015-2315-4bd4-a34f-3530097023de",
    "format": "4",
    "id": "171854118",
    "user_id": "319057"

• recipient_user_id : Die ID des Empfängers eines Transfers oder Pushs. Der Wert ist null, wenn die Daten nicht übertragen oder gepusht wurden.
• answer_time : Datum und Uhrzeit der ersten Speicherung der Daten.
• update_answer_time : Datum und Uhrzeit der letzten Aktualisierung der Daten.
• id_tel : Die eindeutige Kennung, die bei der Installation der Kizeo Forms-App auf dem Mobilgerät erstellt wird. Diese Nummer ändert sich, wenn die App deinstalliert und neu installiert wird.
• media : Liste der Medien, die in den Daten enthalten sind.
• form_id : Die eindeutige ID des Formulars.
• origin : Der Gerätetyp, über den die Aktion durchgeführt wurde :
  • web : Über die Web-Oberfläche.
  • android : Über ein Android-Gerät.
  • ios : Über ein iOS-Gerät.
• app_version : Die Versionsnummer der verwendeten Anwendung.
• device_info : Die Modellbezeichnung des Mobilgeräts sowie das Betriebssystem mit der entsprechenden Version.
• form_update_time : Das Datum, an dem die Version des Formulars gespeichert wurde, das für die Dateneingabe verwendet wurde.
• local_uuid : Die eindeutige Kennung der Daten auf dem Erfassungsgerät.
• format : Die Versionsnummer der JSON-Struktur der Kizeo Forms-Daten.
• id : Die eindeutige Kennung der Daten.
• user_id : Die eindeutige Kennung des Benutzers, der die Daten erfasst hat.

Der Schlüssel fields

Im Schlüssel fields, der sich innerhalb von data befindet, finden Sie die Felder Ihres Formulars sowie die dazugehörigen eingegebenen Werte. Nachfolgend ein Beispiel für die Struktur dieses Teils des JSON.

"fields": {
      "field_id": {
        "result": value,
        "hidden": false,
        ...
      },
      "field_id": {
        "result": value,
        "hidden": true,
        ...
      },
      ...
    },

Sie verfügen nun über die vollständige Liste aller Informationen, die über den Webhook übermittelt werden.