Recevoir une notification quand les médias et résumés IA Blitzz arrivent dans votre stockage

Aperçu

Blitzz transfère les médias des sessions (enregistrements, images, fichiers et résumés d'appel IA) vers votre point de terminaison de stockage personnalisé une fois la session et son traitement terminés. Comme ces fichiers arrivent directement dans votre propre compte infonuagique, la façon la plus simple et la plus fiable de savoir quand un nouvel élément est prêt est d'utiliser le système de notification d'événements natif de votre fournisseur infonuagique.

Blitzz n'offre pas actuellement de webhook pour signaler la disponibilité de chaque fichier. Des webhooks personnalisés peuvent être discutés avec votre équipe de compte, mais les options natives ci-dessous sont immédiates, peu coûteuses et vous donnent un contrôle total de votre côté.

Cet article présente deux configurations :

• Azure Blob Storage avec Azure Event Grid
• AWS S3 avec les notifications d'événements S3

À qui s'adresse cet article?
Aux clients qui utilisent Blitzz avec un point de terminaison de stockage personnalisé (Azure Blob ou AWS S3) et qui veulent être avisés dès qu'un nouvel enregistrement, une nouvelle image ou un nouveau résumé IA arrive dans leur compartiment ou leur conteneur.

---

Option 1 : Azure Blob Storage avec Event Grid

Si votre point de terminaison de stockage personnalisé est un conteneur Azure Blob, Event Grid peut déclencher un événement Microsoft.Storage.BlobCreated dès que Blitzz écrit un nouveau fichier dans votre conteneur. Vous pouvez acheminer cet événement vers une Azure Function, une Logic App, une URL de webhook de votre côté ou tout autre gestionnaire pris en charge.

Ce que vous obtenez

• Une notification instantanée lorsqu'un fichier est créé dans votre conteneur
• La possibilité de filtrer par conteneur, préfixe de chemin ou extension de fichier (par exemple, uniquement pour les fichiers de résumé IA)
• Aucune interrogation périodique requise

Étapes de configuration

1. Connectez-vous au portail Azure et ouvrez le compte de stockage vers lequel Blitzz est configuré pour transférer les fichiers.
2. Dans le menu de gauche, cliquez sur Events.
3. Cliquez sur + Event Subscription.
4. Donnez un nom à l'abonnement (par exemple, blitzz blob created).
5. Sous Event Types, sélectionnez Blob Created. Vous pouvez désélectionner les autres si seuls les nouveaux fichiers vous intéressent.
6. Sous Endpoint Type, choisissez où envoyer les événements :
   • Azure Function pour une logique de traitement personnalisée
   • Webhook pour publier vers votre propre point de terminaison HTTP
   • Logic App pour des flux de travail à faible code
   • Event Hubs, Service Bus ou Storage Queue pour un traitement en file d'attente
7. (Facultatif) Sous Filters, affinez les événements. Par exemple :
   • Le sujet commence par /blobServices/default/containers/your_container_name/blobs/
   • Le sujet se termine par .json si vous voulez uniquement les fichiers de résumé IA
   • Le sujet se termine par .mp4 si vous voulez uniquement les enregistrements
8. Cliquez sur Create.

Contenu de l'événement

Les données d'un événement Blob Created comprennent l'URL du blob, le nom du conteneur, la taille du fichier, le type de contenu et l'appel d'API qui l'a écrit. Votre gestionnaire peut récupérer le fichier directement à partir de l'URL ou déclencher une synchronisation vers un autre système.

Référence

Événements Azure Blob Storage : https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-event-overview

---

Option 2 : AWS S3 avec les notifications d'événements S3

Si votre point de terminaison de stockage personnalisé est un compartiment AWS S3, les notifications d'événements S3 peuvent se déclencher à chaque événement s3:ObjectCreated:*. Vous pouvez acheminer l'événement vers SNS, SQS, Lambda ou Amazon EventBridge.

Ce que vous obtenez

• Une notification en temps réel lorsque Blitzz téléverse un nouvel objet
• Le filtrage par préfixe (chemin du dossier) et suffixe (extension de fichier)
• La diffusion vers plusieurs abonnés avec SNS ou le traitement en file d'attente avec SQS
• L'exécution directe d'une fonction Lambda si vous voulez traiter le fichier immédiatement

Étapes de configuration dans la console AWS

1. Connectez-vous à la console AWS et ouvrez S3.
2. Cliquez sur le compartiment vers lequel Blitzz est configuré pour transférer les fichiers.
3. Allez à l'onglet Properties.
4. Faites défiler jusqu'à Event notifications et cliquez sur Create event notification.
5. Donnez un nom à la notification (par exemple, blitzz object created).
6. (Facultatif) Sous Prefix et Suffix, précisez quels objets déclenchent l'événement :
   • Exemple de préfixe : sessions/ pour surveiller uniquement les fichiers de ce dossier
   • Exemples de suffixe : .json pour les résumés IA, .mp4 pour les enregistrements, .jpg pour les images
7. Sous Event types, sélectionnez All object create events (ou choisissez des événements précis comme Put et Multipart upload completed).
8. Sous Destination, choisissez l'une des options suivantes :
   • Lambda function pour un traitement personnalisé
   • SNS topic pour diffuser vers plusieurs abonnés, y compris des adresses courriel ou des points de terminaison HTTPS
   • SQS queue pour un traitement fiable en file d'attente
9. Sélectionnez la ressource de destination et cliquez sur Save changes.

Acheminement vers un webhook de votre côté

S3 ne peut pas publier directement vers un point de terminaison HTTPS. La méthode habituelle est donc la suivante :

• S3 vers SNS vers HTTPS : créez une rubrique SNS, abonnez-y votre point de terminaison HTTPS et confirmez l'abonnement. SNS enverra ensuite chaque événement à votre URL par requête POST.
• S3 vers Lambda vers votre point de terminaison : écrivez une petite fonction Lambda qui reçoit l'événement S3 et appelle votre API interne.
• S3 vers EventBridge : activez EventBridge sur le compartiment et utilisez des règles pour acheminer les événements vers des dizaines de cibles prises en charge, y compris API Destinations pour n'importe quelle URL HTTPS.

Contenu de l'événement

Les données d'un événement S3 ObjectCreated comprennent le nom du compartiment, la clé de l'objet, sa taille, l'ETag et l'heure de l'événement. Votre gestionnaire peut utiliser la clé pour générer une URL présignée ou synchroniser le fichier ailleurs.

Référence

Notifications d'événements AWS S3 : https://docs.aws.amazon.com/AmazonS3/latest/userguide/EventNotifications.html

---

Conseils et pratiques exemplaires

• Filtrez de façon rigoureuse. Une session Blitzz typique écrit plusieurs fichiers (enregistrement, images, résumé IA). Si un seul type vous intéresse, filtrez par extension de fichier ou par préfixe de chemin pour éviter de surcharger votre gestionnaire.
• Moment du résumé IA. Les fichiers de résumé d'appel IA sont écrits après la fin de la session et du traitement. Si vous dépendez précisément du résumé, surveillez l'extension ou le chemin du fichier de résumé plutôt que l'enregistrement, puisqu'ils n'arrivent pas au même moment.
• Idempotence. Dans de rares cas, un événement peut être livré plus d'une fois. Assurez-vous que votre gestionnaire peut traiter deux fois le même fichier sans problème.
• Testez avec une vraie session. La façon la plus simple de valider votre configuration est de lancer une session Blitzz de test, de la laisser se terminer et de vérifier le déclenchement de l'événement dans les journaux de votre gestionnaire.

---

Besoin d'aide?

Si vous avez configuré votre point de terminaison de stockage avec Blitzz et que les fichiers n'arrivent pas, ou si vous avez besoin d'aide pour choisir entre Event Grid, SNS, SQS ou Lambda, veuillez soumettre un billet de soutien et notre équipe vous aidera à effectuer la configuration.