Marketing
Wistia dans votre produit et vos agents IA, via une API
Le toolkit Wistia couvre médias, dossiers et sous-dossiers, ainsi que les analytics du compte et de chaque vidéo : lectures, play rate, engagement et série temporelle. Votre produit ou agent IA les appelle via Connect, qui stocke la clé API du client et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/wistia_create_folder/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Fonctionnement
Du client connecté au premier appel à Wistia.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Wistia. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Wistia.
Analytics vidéo dans votre tableau de bord
Un SaaS récupère plays, play_rate et engagement_rate sur une période et les affiche à côté de ses propres métriques.
Rapports de performance de contenu
Un outil d'agence classe les médias ou dossiers d'un compte selon une métrique et lit la série temporelle d'une vidéo par jour, semaine ou mois.
Agent qui organise la bibliothèque
Un agent IA renomme et tague des médias, crée des dossiers et déplace jusqu'à 100 médias à la fois.
Tools
12 tools Wistia
- Lister les médiasGETListe les médias du compte (vidéos, audios, images et documents) avec hashed_id, name, type, status, durée en secondes, dossier, sous-dossier, miniature et dates.
- Obtenir un médiaGETRenvoie un média : name, type, status, durée en secondes, description, dossier, sous-dossier, tags, miniature, les fichiers dans assets et dates.
- Mettre à jour un médiaPUTMet à jour le nom, la description ou les tags d'un média et le renvoie. Les champs omis gardent leur valeur, mais tags remplace toute la liste de tags du média.
- Déplacer des médiasPUTDéplace jusqu'à 100 médias vers un dossier, ou vers un sous-dossier de ce dossier. Wistia exécute le déplacement en arrière-plan et répond avec le statut d'un background job.
- Lister les dossiersGETListe les dossiers partagés du compte avec hashed_id, name, description, media_count, indicateur public et dates. Les dossiers My Library de chaque utilisateur ne sont pas inclus.
- Créer un dossierPOSTCrée un dossier partagé dans le compte, appartenant à l'Account Owner, et le renvoie avec son hashed_id.
- Mettre à jour un dossierPUTMet à jour le nom, la description ou l'accès d'un dossier et le renvoie. Les champs omis gardent leur valeur.
- Lister les sous-dossiersGETListe les sous-dossiers d'un dossier avec hashed_id, name, description, position et dates. Pagination par page : la liste se termine quand une page contient moins d'éléments que per_page.
- Obtenir les analytics du compteGETRenvoie les totaux de tout le compte sur une plage de dates : plays, unique plays, unique loads, play_rate et engagement_rate (de 0 à 1), played_time en secondes et plus.
- Lister les contenus les plus vusGETClasse les médias, chaînes ou dossiers du compte selon une métrique sur une plage de dates, avec plays, play_rate, engagement_rate, played_time en secondes et visiteurs uniques.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
Questions sur le toolkit Wistia
Dois-je intégrer l'API Wistia moi-même ?
Non. Connect fournit 12 tools Wistia décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Wistia ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
