Comment configurer des webhooks pour recevoir des notifications lors de la publication d’un clip (épisode)

Recevez des notifications lorsqu’un clip (épisode) est publié.

Omny Studio fournit un abonnement à des webhooks qui nous permet d’envoyer des notifications à un point de terminaison. Dans cet article, vous trouverez des informations générales et des conseils sur la configuration d’un webhook.

Après avoir configuré l’abonnement au webhook, vous pourrez ensuite configurer les paramètres afin d'être averti lorsqu’un clip est en cours de publication.

Paramètres du webhook

Les paramètres du webhook se trouvent sur la page « Webhooks » de vos « paramètres de l’organisation ». En cliquant sur le bouton ...  et la Edit webhook bouton, vous arriverez à Edit webhook .

Par défaut, la mise en place d’un abonnement webhook vous permettra de recevoir tous les événements proposés par Omny Studio.

Afin de recevoir une notification lorsqu’un clip (épisode) est en cours de publication, vous pouvez vous concentrer spécifiquement sur l' Clip visibility changed (ClipVisiblityChanged) événement. Cet événement pourra être utilisé pour déterminer si un clip a été publié ou non.

En sélectionnant cet événement, vous recevrez des notifications lorsqu’un clip a été publié ou supprimé.

Les notifications envoyées pour cet événement auront la structure JSON suivante :

{
 "Type": "ClipVisibilityChanged",
 "Timestamp": "2020-08-13T01:56:00Z",
 "EventId": "37a2dae4-4bc0-473b-b8c5-ac1600c4b376",
 "ChangeId": "f07876b6-ea54-4246-ab17-49b9d70ed16a",
 "Current": {
    "Id": "7749ccba-664c-46fd-8cc0-ac16009e4659",
    "Title": "Publish Clip Example",
    "Visibility": "Unlisted",
    ...
  }
}

Comme vous pouvez le voir ci-dessus, le type de notification appartient à une catégorie ClipVisibilityChanged spécifique. La propriété qui vous permettra d'identifier le statut de publication d’un clip est la Visibility .

En utilisant les valeurs de la propriété, il vous sera possible d'identifier le moment où un clip a été publié par un utilisateur.

Remarque : Par défaut, tous les clips qui viennent d’être créés auront un statut de publication private. Si l’utilisateur n’a pas modifié le statut par défaut sur la page de création du clip, l’ ClipVisibilityChanged événement ne sera pas envoyé. Toutefois, si l’utilisateur crée un clip et choisit un statut de publication autre que Private un astérisque ClipVisiblityChanged l'évènement sera envoyé avec le statut approprié défini dans le Visibility .

Création d’un clip avec un statut privé par défaut

Cliquer sur le bouton Enregistrer les modifications n’enverra pas d'événement ClipVisibilityChanged car le statut de publication est défini sur Private sur l’écran Créer un clip.

Création d’un clip doté d'un statut Public/Non répertorié/Restreint