doo in Frisbii Media einrichten

Überblick

doo ist eine Eventmanagement-Plattform für Live-, Hybrid- und virtuelle Veranstaltungen. Wenn Du Frisbii Media mit doo verbindest, werden Kunden, die ein doo-fähiges Angebot kaufen, automatisch in die Teilnehmerliste in doo aufgenommen. So kannst Du Webinar-Abonnements, einzelne Eventtickets oder Bundles aus Veranstaltungen und Publikationen verkaufen.

Einschränkungen

Nur Einzelprodukt-Angebote und zeitbasierte Abonnement-Angebote funktionieren mit doo. Andere Angebotstypen, zum Beispiel verbrauchsbasierte Angebote, werden nicht unterstützt.
Änderungen an Kundendaten, die direkt in doo vorgenommen werden, werden nicht zu Frisbii Media zurückübertragen.

Hinweis

Das doo-Modul ist eine kostenpflichtige Erweiterung von Frisbii Media. Für ein unverbindliches Angebot wende Dich an support@frisbii.com. Mehr über doo erfährst Du unter https://www.doo.net/.

Bevor Du beginnst

Das doo-Modul ist in Deinem Vertragsunternehmen aktiviert.
Du hast die Verbindungsdaten für doo: die URL des Webservice, Benutzername und Passwort für die Authentifizierung sowie das Secret.

doo aktivieren und konfigurieren

Öffne den Menüpunkt Einstellungen → Entwicklung → Partner-Einstellungen.
Klicke auf doo aktivieren und konfigurieren. Ein Dialog öffnet sich.
Gib die URL des Webservice inklusive Protokoll ein (zum Beispiel https://my-endpoint.com). An diese URL sendet Frisbii Media die doo-Callbacks.
Gib den Benutzernamen für die Authentifizierung und das Passwort für die Authentifizierung ein.
Gib das Secret ein.
Klicke auf Aktivieren und speichern. Frisbii Media erzeugt den Token für die Verbindung zu doo.

Wenn die Aktivierung abgeschlossen ist, wird doo auf der Seite Partner-Einstellungen als aktiv angezeigt.

Angebot für doo-Events verwenden

Öffne den Menüpunkt Angebote und öffne das Angebot, das Du für doo-Events verwenden möchtest.
Klicke in der Aktionsleiste auf Partner-Einstellungen → doo Einstellungen. Ein Dialog öffnet sich.
Aktiviere Mit diesem Angebot doo-Events steuern.
Klicke auf Speichern.

Wenn die Einstellung gespeichert ist, siehst Du die Meldung „Die Einstellungen wurden erfolgreich gespeichert.“ Ab jetzt wird jeder Kunde, der dieses Angebot kauft oder ein aktives Abonnement dafür hat, in die Teilnehmerliste in doo aufgenommen.

Was Frisbii Media an doo sendet

Frisbii Media sendet einen Callback an doo, wenn ein Kunde ein doo-fähiges Angebot kauft, und erneut bei jeder Änderung des Abonnements, zum Beispiel bei einer Kündigung. Alle doo-Callbacks haben den Entitätstyp DOO_EVENT_ACCESS. Der callbackType zeigt doo, was passiert ist:

CREATION: Ein Kunde hat einen neuen Zugang erhalten, zum Beispiel durch den Kauf des Angebots.
CHANGE: Ein bestehender Zugang hat sich geändert, zum Beispiel weil das Abonnement gekündigt wurde.

Hinweis

Der Callback enthält keine personenbezogenen Daten wie Name oder E-Mail-Adresse. doo ruft diese Daten über die Frisbii Media API anhand der customerId ab.

Beispiel: Abonnement angelegt

{
  "entityType": "DOO_EVENT_ACCESS",
  "callbackType": "CREATION",
  "entityId": "1230394",
  "entity": {
    "accessRightUniqueId": "daily-paper",
    "companyId": "XKNTGM614AQPVXGOD287",
    "customerId": "99",
    "multiuserSubscriptionCancellationDate": null,
    "multiuserSubscriptionEndDate": null,
    "multiuserSubscriptionStartDate": null,
    "orderValidityEndDate": null,
    "quantity": 1,
    "subscription": true,
    "subscriptionCancellationDate": null,
    "subscriptionEndDate": null,
    "subscriptionId": 1230414,
    "subscriptionItemId": 1230505,
    "subscriptionStartDate": "2026-10-28T09:27:48.433607Z"
  }
}

Kunde 99 hat ein neues Abonnement mit dem Zugriffsrecht daily-paper, das am 28. Oktober 2026 beginnt. Das Abonnement hat weder ein Kündigungsdatum noch ein Enddatum, der Zugang gilt also unbefristet.

Beispiel: Abonnement gekündigt

{
  "entityType": "DOO_EVENT_ACCESS",
  "callbackType": "CHANGE",
  "entityId": "1230414",
  "entity": {
    "accessRightUniqueId": "daily-paper",
    "companyId": "XKNTGM614AQPVXGOD287",
    "customerId": "99",
    "multiuserSubscriptionCancellationDate": null,
    "multiuserSubscriptionEndDate": null,
    "multiuserSubscriptionStartDate": null,
    "orderValidityEndDate": null,
    "quantity": 1,
    "subscription": true,
    "subscriptionCancellationDate": "2026-10-28T09:31:40.781599Z",
    "subscriptionEndDate": "2026-11-28T00:00:00Z",
    "subscriptionId": 1230414,
    "subscriptionItemId": 1230505,
    "subscriptionStartDate": "2026-10-28T09:27:48.433607Z"
  }
}

Dasselbe Abonnement (subscriptionId 1230414) wurde am 28. Oktober 2026 gekündigt. Der Zugang bleibt bis zum subscriptionEndDate am 28. November 2026 gültig. Bis dahin bleibt Kunde 99 Teilnehmer.

Felder im Callback

Feld	Bedeutung
`entityType`	Bei doo-Callbacks immer `DOO_EVENT_ACCESS`.
`callbackType`	`CREATION` für einen neuen Zugang, `CHANGE` für eine Änderung an einem bestehenden Zugang.
`entityId`	ID des Objekts, das den Callback ausgelöst hat: die Bestell-ID bei `CREATION`, die Abonnement-ID bei `CHANGE`.
`accessRightUniqueId`	Das Zugriffsrecht, das das Angebot vergibt. Darüber ordnet doo den Zugang einer Veranstaltung oder Veranstaltungsreihe zu.
`companyId`	ID Deines Unternehmens in Frisbii Media.
`customerId`	Kundennummer des Teilnehmers in Frisbii Media.
`quantity`	Anzahl der gekauften Angebote
`subscription`	`true` bei einem Abonnement, `false` bei einem Einzelprodukt.
`subscriptionId`, `subscriptionItemId`	IDs des Abonnements und der Abonnementposition. Über die `subscriptionId` lassen sich spätere `CHANGE`-Callbacks demselben Abonnement zuordnen.
`subscriptionStartDate`	Datum, ab dem der Zugang gilt.
`subscriptionCancellationDate`	Datum der Kündigung. `null`, wenn das Abonnement nicht gekündigt ist.
`subscriptionEndDate`	Datum, an dem der Zugang endet. `null`, wenn das Abonnement bis zur Kündigung läuft.
`orderValidityEndDate`	Bei Einzelprodukten: Datum, an dem der Zugang endet. `null`, wenn es kein Enddatum gibt.
`multiuserSubscriptionStartDate`, `multiuserSubscriptionCancellationDate`, `multiuserSubscriptionEndDate`	Dieselben Daten für einen Platz in einem Mehrbenutzer-Abonnement. Bei allen anderen Abonnements `null`.

Alle Datumsangaben sind in UTC (Format ISO 8601).

Wie doo die Callbacks auswerten sollte

Den Teilnehmer über die customerId und die Veranstaltung oder Veranstaltungsreihe über die accessRightUniqueId identifizieren.
Einen CHANGE-Callback über die subscriptionId dem ursprünglichen Abonnement zuordnen und immer den neuesten Callback anwenden.
Ein Zugang gilt für eine Veranstaltung, wenn das Startdatum am oder vor dem Veranstaltungsdatum liegt und das Enddatum leer ist oder nach dem Veranstaltungsdatum liegt.
Eine Kündigung beendet den Zugang nicht sofort. Den Teilnehmer bis zum subscriptionEndDate behalten, nicht nur bis zum subscriptionCancellationDate.
Bei Einzelprodukten (subscription ist false) das orderValidityEndDate statt der Abonnementdaten verwenden.
Über quantity ermitteln, wie viele Tickets oder Plätze der Kunde hat.

Um zu prüfen, ob ein Callback bei doo angekommen ist, öffne das Callback-Log und filtere nach dem doo-Entitätstyp.