KORONA.entry verbinden

Verwenden Sie dies, um KORONA Event mit einem KORONA.entry-Server zu verbinden, damit verkaufte Tickets an Eingängen und Drehkreuzen gescannt werden können und die Verbindung auch nach Änderungen der Anmeldedaten aufrechterhalten bleibt. KORONA Event scannt Tickets nicht selbst; das Scannen erfolgt durch die KORONA.entry-Hardware.

Integrationseinstellungen und Verbindungsstatus im Backoffice — Nutzen Sie den Bereich „Integrationen“, um Anmeldedaten, den Verbindungsstatus und die Einrichtung externer Systeme zu überprüfen.

Bevor Sie beginnen

Bestätigen Sie:

Sie verfügen über die URL, den Benutzernamen und das Passwort des KORONA.entry-Servers
Sie haben im Backoffice Zugriff auf Verwaltung > Integrationen
Sie kennen die Zeitzone Ihres KORONA Event-Kontos

Schritte

Öffnen Sie im Backoffice Verwaltung > Integrationen.
Geben Sie im Abschnitt KORONA.entry-Integration den Benutzernamen, das Passwort und die URL ein.
Wählen Sie Speichern und synchronisieren. Die Meldung „KORONA.entry-Integration erfolgreich synchronisiert“ bestätigt, dass KORONA Event den Entry-Server mit diesen Anmeldedaten erreichen kann.
Richten Sie in KORONA.entry die Eingangs-Webhooks und den Ereignisempfänger ein, damit die Scanergebnisse an KORONA Event zurückgesendet werden. Befolgen Sie die Anleitung unter Scanner und Einlasshardware einrichten.

Wie der Datenfluss zwischen den Systemen erfolgt

Nachdem ein Ticket verkauft wurde, aktiviert KORONA Event dieses in KORONA.entry, damit es von den Schranken erkannt wird.
Scan-Ergebnisse, die Erstellung von Tickets sowie Ticketaktualisierungen in KORONA.entry werden über Entry-Webhooks an KORONA Event zurückgesendet und als Entry-Ereignisse im entsprechenden Ticket erfasst, einschließlich abgelehnter Scans und des jeweiligen Grundes.

Personalisierte Tickets

Wenn ein Angebot Name und Foto des Ticketinhabers abfragt, überträgt KORONA Event diese Angaben in das KORONA.entry-Ticket. Die Einrichtung beschreibt Personalisierte Tickets mit Name und Foto des Ticketinhabers verkaufen.

Ticketangabe in KORONA.entry	Herkunft
Vorname und Nachname	Die Antworten Vorname und Nachname des Teilnehmers. Bei personalisierten Tickets bleibt eine fehlende Namensangabe leer.
Foto	Die Antwort Ausweisfoto des Teilnehmers, hochgeladen als Ticketbild. Ohne Antwort hat das Ticket kein Foto.
Kundennummer	Die KORONA-Kundennummer des Käufers, es sei denn, Ihr Konto ist so eingerichtet, dass für jeden Ticketinhaber ein eigener Kunde angelegt wird (siehe unten).

Name und Foto werden bei der Aktivierung des Tickets übertragen. Wenn Mitarbeitende oder Kunden später eine Namens- oder Fotoantwort ergänzen oder ändern, wird das KORONA.entry-Ticket automatisch aktualisiert. Die Kasse fragt beim Verkauf keine Ticketinhaberdaten ab. Personalisierte Tickets bleiben ohne Namen, bis diese Angaben vorliegen; das Ergänzen im Backoffice aktualisiert das Ticket. Tickets ohne Fragen zur Identität des Inhabers verwenden weiterhin den Namen des Käufers.

Verwenden Sie Antwort bearbeiten, um einen Namen zu korrigieren oder ein Foto zu ersetzen. Wenn Sie eine optionale Namensantwort leer speichern, wird dieser Namensteil auf dem personalisierten Ticket gelöscht. Erforderliche Antworten müssen ausgefüllt sein. Das Löschen einer vollständigen Antwort wird nicht mit KORONA.entry synchronisiert; das Entfernen eines Fotos löscht das Foto in KORONA.entry nicht.

Wenn Ihr Konto eigene Kunden für Ticketinhaber anlegt, erhält ein Ticket, dessen Inhabername vom Käufer abweicht, einen eigenen Kunden mit der E-Mail-Adresse des Käufers. Sie finden diese Kunden unter Verkauf > Kunden; ihr Kommentar zum Kunden lautet „Erstellt aus der ursprünglichen Kundennummer … für ein personalisiertes Ticket.“, und Externe Referenz enthält die Kundennummer des Käufers.

Änderungen an den Zugangsdaten

Wenn das Passwort oder der Benutzername auf dem KORONA.entry-Server geändert wird, schlagen KORONA Event-Anfragen mit Autorisierungsfehlern fehl, es kommt zu einem Rückstau bei der Ticketaktivierung, und neu verkaufte Tickets werden nicht mehr an die Drehkreuze weitergeleitet.

Passen Sie Benutzername, Passwort und URL im Abschnitt KORONA.entry-Integration an.
Wählen Sie Speichern und synchronisieren. Dadurch werden ausstehende Ticketaktivierungen und verzögerte Scan-Aktualisierungen fortgesetzt.
Verkaufen Sie ein Test-Ticket oder wählen Sie eines aus und vergewissern Sie sich, dass es am Eingang gescannt werden kann.

Wenn Sie ein anderes KORONA-Konto verbinden, generiert KORONA Event einen neuen Webhook-Benutzernamen und ein neues Webhook-Passwort für dieses Konto. Wählen Sie unter Eintrags-Webhooks die Option Werte für Eintrags-Webhooks generieren und erstellen oder ersetzen Sie anschließend den Ereignisempfänger im neu verbundenen KORONA.entry-Konto mit genau diesen Werten. Der Ereignisempfänger des vorherigen Kontos kann keine Ereignisse mehr an dieses KORONA Event-Konto senden.

Erwartetes Ergebnis

Neue Tickets werden kurz nach dem Kauf an den Eingängen akzeptiert, und jeder Scan wird in den Teilnehmerdetails des Backoffice als Eintrittsereignis auf dem Ticket angezeigt.

Fehlerbehebung

Problem	Was Sie überprüfen sollten
Die Synchronisierung schlägt mit einem Autorisierungsfehler fehl	Benutzername und Passwort stimmen mit den aktuellen Anmeldedaten für KORONA.entry überein, und die URL verweist auf den richtigen Server.
Am Eingang sind keine neuen Eintrittskarten erhältlich	Überprüfen Sie, ob die letzte Synchronisierung erfolgreich war. Nachdem Sie die Anmeldedaten korrigiert haben, wählen Sie Speichern und synchronisieren, um die in der Warteschlange befindlichen Aktivierungen freizugeben.
Scans werden in KORONA Event nicht angezeigt	Überprüfen Sie die Konfiguration des Ereignisempfängers und ob unter „Webhooks“ ein kürzlich empfangenes Ereignis angezeigt wird. Nachdem Sie die Verbindung korrigiert oder fehlende Ticketdaten ergänzt haben, wählen Sie Synchronisieren, um die gespeicherten Scan-Ereignisse erneut zu verarbeiten. Falls Sie die Verbindungseinstellungen geändert haben, wählen Sie stattdessen Speichern und synchronisieren.
Gültige Tickets, die kurz vor Mitternacht oder an Datumsgrenzen abgelehnt wurden	Die Zeitzone des KORONA.entry-Servers entspricht der Zeitzone Ihres Kontos.