Configurer doo dans Frisbii Media

Présentation

doo est une plateforme de gestion d'événements en présentiel, hybrides et virtuels. Lorsque vous connectez Frisbii Media à doo, les clients qui achètent une offre activée pour doo sont automatiquement ajoutés à la liste des participants dans doo. Vous pouvez ainsi vendre des abonnements à des webinaires, des billets pour des événements individuels ou des offres groupées composées d'événements et de publications.

Avant de commencer

• Le module doo est activé pour votre société contractante.

• Vous disposez des données de connexion à doo : l'URL du service web, le nom d'utilisateur et le mot de passe pour l'authentification, ainsi que le secret.

Activer et configurer doo

1. Ouvrez l'élément de menu Paramètres → Développement → Paramètres des partenaires.

2. Cliquez sur Activer et configurer doo. Une boîte de dialogue s'ouvre.

3. Saisissez l'URL du service web, protocole compris (par exemple https://my-endpoint.com). Frisbii Media envoie les callbacks doo à cette URL.

4. Saisissez le nom d'utilisateur pour l'authentification et le mot de passe pour l'authentification.

5. Saisissez le secret.

6. Cliquez sur Activer et enregistrer. Frisbii Media génère le jeton de connexion à doo.

Une fois l'activation terminée, doo apparaît comme actif sur la page Paramètres des partenaires.

Utiliser une offre pour les événements doo

1. Ouvrez l'élément de menu Offres et ouvrez l'offre que vous souhaitez utiliser pour les événements doo.

2. Dans la barre d'actions, cliquez sur Paramètres des partenaires → Paramètres doo. Une boîte de dialogue s'ouvre.

3. Cochez Utiliser cette offre pour les événements doo.

4. Cliquez sur Enregistrer.

Une fois le paramètre enregistré, le message « Les paramètres ont été enregistrés avec succès. » s'affiche. Désormais, chaque client qui achète cette offre ou qui dispose d'un abonnement actif à celle-ci est ajouté à la liste des participants dans doo.

Données envoyées par Frisbii Media à doo

Frisbii Media envoie un callback à doo lorsqu'un client achète une offre activée pour doo, puis à chaque modification de l'abonnement, par exemple lors d'une résiliation. Tous les callbacks doo ont le type d'entité DOO_EVENT_ACCESS. Le callbackType indique à doo ce qui s'est passé :

• CREATION : un client a obtenu un nouvel accès, par exemple en achetant l'offre.

• CHANGE : un accès existant a été modifié, par exemple parce que l'abonnement a été résilié.

Exemple : abonnement créé

{
  "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"
  }
}

Le client 99 dispose d'un nouvel abonnement avec le droit d'accès daily-paper, qui commence le 28 octobre 2026. L'abonnement n'a ni date de résiliation ni date de fin : l'accès est donc valable sans limite de durée.

Exemple : abonnement résilié

{
  "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"
  }
}

Le même abonnement (subscriptionId 1230414) a été résilié le 28 octobre 2026. L'accès reste valable jusqu'à la subscriptionEndDate, le 28 novembre 2026. D'ici là, le client 99 reste participant.

Champs du callback

Toutes les dates sont exprimées en UTC (format ISO 8601).

Comment doo doit évaluer les callbacks

• Identifier le participant par le customerId et l'événement ou la série d'événements par l'accessRightUniqueId.

• Associer un callback CHANGE à l'abonnement d'origine via le subscriptionId et toujours appliquer le callback le plus récent.

• Un accès est valable pour un événement si la date de début est antérieure ou égale à la date de l'événement et si la date de fin est vide ou postérieure à la date de l'événement.

• Une résiliation ne met pas fin à l'accès immédiatement. Conserver le participant jusqu'à la subscriptionEndDate, et non jusqu'à la subscriptionCancellationDate.

• Pour les produits uniques (subscription vaut false), utiliser l'orderValidityEndDate au lieu des dates d'abonnement.

• Utiliser quantity pour connaître le nombre de billets ou de places du client.

Pour vérifier si un callback est bien parvenu à doo, ouvrez le journal des callbacks et filtrez par le type d'entité doo.