Marketing
Vimeo en tu producto y en tus agentes de IA, con una API
El toolkit de Vimeo cubre los videos de la cuenta conectada, sus carpetas y sus comentarios. Tu producto o agente de IA lee detalles y reproducciones de videos, actualiza títulos y privacidad, mueve videos entre carpetas y responde comentarios por Connect, que maneja la conexión OAuth y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/vimeo_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 Vimeo.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Vimeo. 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 Vimeo.
Biblioteca de videos en tu producto
Un SaaS lista los videos de Vimeo del cliente con name, link, embed y stats.plays y los muestra en su propia interfaz.
Organiza los videos de los clientes
Una herramienta de agencia crea una carpeta por cliente, anida subcarpetas y mueve cada video a la correcta.
Agente de respuestas
Un agente de IA lee los comentarios de un video y publica una respuesta como el usuario conectado.
Tools
10 tools de Vimeo
- Listar videosGETLista los videos subidos por el usuario conectado, con uri, name, description, link, duration, privacy, parent_folder, tags, código de embed y stats.plays, el conteo de reproducciones.
- Obtener videoGETDevuelve un video: name, description, link, duration, dimensiones, privacy, status, parent_folder, tags, código de embed, miniaturas y stats.plays, el conteo de reproducciones.
- Actualizar videoPATCHActualiza el título, la descripción, la privacidad o la licencia de un video del usuario conectado y lo devuelve. Los campos omitidos conservan su valor.
- Listar carpetasGETLista las carpetas del usuario conectado, con uri, name, link, fechas y el número de videos en metadata.connections.videos.total.
- Crear carpetaPOSTCrea una carpeta para el usuario conectado y la devuelve con su uri. Sin parent_folder_uri es una carpeta de nivel superior; las carpetas se anidan hasta 10 niveles.
- Actualizar carpetaPATCHRenombra una carpeta del usuario conectado y la devuelve.
- Listar videos de la carpetaGETLista los videos de una carpeta, con uri, name, description, link, duration, privacy, tags y stats.plays, el conteo de reproducciones. Paginación por página.
- Mover video a carpetaPUTColoca un video en una carpeta del usuario conectado, que debe ser el dueño de la carpeta. Responde 204 sin cuerpo cuando funciona.
- Listar comentarios del videoGETLista los comentarios de un video, con uri, text, author, fecha y el número de respuestas en metadata.connections.replies.total.
- Crear respuesta a comentarioPOSTResponde a un comentario de un video como el usuario conectado y devuelve la respuesta, que es pública como cualquier comentario del video.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/vimeo, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Vimeo
¿Necesito implementar la API de Vimeo?
No. Connect ya trae 10 tools de Vimeo 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 Vimeo?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. 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.
