Marketing
Wistia en tu producto y en tus agentes de IA, con una API
El toolkit de Wistia cubre medios, carpetas y subcarpetas, además de analíticas de la cuenta y de cada video: reproducciones, play rate, engagement y serie temporal. Tu producto o agente de IA los llama por Connect, que guarda la API key del cliente y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
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>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Wistia.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Wistia. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Wistia.
Analíticas de video en tu panel
Un SaaS obtiene plays, play_rate y engagement_rate de un período y los muestra junto a sus propias métricas.
Informes de rendimiento de contenido
Una herramienta de agencia ordena los medios o carpetas de una cuenta por una métrica y lee la serie temporal de un video por día, semana o mes.
Agente que organiza la biblioteca
Un agente de IA renombra y etiqueta medios, crea carpetas y mueve hasta 100 medios a la vez.
Tools
12 tools de Wistia
- Listar mediosGETLista los medios de la cuenta (videos, audios, imágenes y documentos) con hashed_id, name, type, status, duración en segundos, carpeta, subcarpeta, miniatura y fechas.
- Obtener medioGETDevuelve un medio: name, type, status, duración en segundos, description, carpeta, subcarpeta, tags, miniatura, los archivos en assets y fechas.
- Actualizar medioPUTActualiza el nombre, la descripción o las tags de un medio y lo devuelve. Los campos omitidos conservan su valor, pero tags reemplaza toda la lista de tags del medio.
- Mover mediosPUTMueve hasta 100 medios a una carpeta, o a una subcarpeta de esa carpeta. Wistia ejecuta el movimiento en segundo plano y responde con el estado de un background job.
- Listar carpetasGETLista las carpetas compartidas de la cuenta con hashed_id, name, description, media_count, indicador de público y fechas. Las carpetas My Library de cada usuario no están incluidas.
- Crear carpetaPOSTCrea una carpeta compartida en la cuenta, propiedad del Account Owner, y la devuelve con su hashed_id.
- Actualizar carpetaPUTActualiza el nombre, la descripción o el acceso de una carpeta y la devuelve. Los campos omitidos conservan su valor.
- Listar subcarpetasGETLista las subcarpetas de una carpeta con hashed_id, name, description, position y fechas. Paginación por página: la lista termina cuando una página trae menos elementos que per_page.
- Obtener analíticas de la cuentaGETDevuelve los totales de toda la cuenta en un rango de fechas: plays, unique plays, unique loads, play_rate y engagement_rate (de 0 a 1), played_time en segundos y más.
- Listar contenido más vistoGETOrdena los medios, canales o carpetas de la cuenta por una métrica en un rango de fechas, con plays, play_rate, engagement_rate, played_time en segundos y visitantes únicos.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Wistia
¿Necesito implementar la API de Wistia?
No. Connect ya trae 12 tools de Wistia descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Wistia?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
