# Flujo de trabajo de Zapier

> Conecta la WayinVideo API con Zapier para automatizar YouTube, Zoom, Google Sheets, AI Clipping, resúmenes de vídeo y flujos de transcripción.

## Integración de automatización de vídeo con Zapier

Usa **Zapier** para conectar WayinVideo API con apps como Google Sheets, Google Drive, YouTube, Zoom, Slack, Gmail, Airtable, Notion y HubSpot.

Zapier encaja bien en flujos no-code ligeros donde un evento de negocio debe iniciar una tarea de procesamiento de vídeo: resumir una nueva grabación, transcribir una reunión, crear candidatos de clips desde un vídeo de YouTube o enviar highlights al equipo.

Con WayinVideo API y Webhooks by Zapier, puedes crear flujos de automatización de vídeo con IA para operaciones de contenido, reutilización de podcasts, seguimiento de webinars, recaps de reuniones, revisión de clips sociales y colas de investigación de vídeo.

> WayinVideo no requiere una app dedicada de Zapier. Puedes conectarte mediante **Webhooks by Zapier** usando tu API key de WayinVideo.

---

## Qué puedes automatizar con Zapier

- **YouTube a AI clips**: Detecta nuevas subidas de un canal y genera candidatos de clips con títulos, descripciones, hashtags, timestamps y puntuaciones virales.
- **Resúmenes de grabaciones de Zoom**: Convierte grabaciones de webinars o reuniones en resúmenes estructurados y highlights de la línea de tiempo.
- **Colas de vídeo en Google Sheets**: Procesa filas de URLs de vídeo y escribe los resultados en la misma hoja.
- **Flujos de transcripción**: Envía URLs de vídeo o audio a la [Video Transcription API](https://wayin.ai/es/api-docs/video-transcription/) y guarda transcripciones en Airtable, Notion o un CMS.
- **Flujos de revisión de clips**: Genera primero metadatos de clips y deja que tu equipo decida qué clips exportar con la [Clips Export API](https://wayin.ai/es/api-docs/clips-export/).

---

## Cómo funciona

La mayoría de flujos de Zapier siguen este patrón:

1. **Trigger**: Una nueva fila, archivo, envío de formulario, vídeo o grabación de reunión inicia el Zap.
2. **Enviar**: Webhooks by Zapier envía una solicitud HTTP a un endpoint de WayinVideo API.
3. **Esperar / Consultar**: Zapier consulta el endpoint de resultados hasta que `status` sea `SUCCEEDED` o `FAILED`.
4. **Enrutar**: Zapier envía resúmenes, transcripciones, metadatos de clips o enlaces de exportación a otra app.

Recomendamos consultar el estado de la tarea cada **30 segundos**.

---

## Ejemplo: Resumir vídeos desde Google Sheets

Este flujo usa la [Video Summarization API](https://wayin.ai/es/api-docs/video-summarization/) para convertir URLs de vídeo en una hoja en resúmenes estructurados y highlights de la línea de tiempo.

Trigger:
Nueva fila en Google Sheets con una columna `video_url`.

Pasos:
1. Usar Webhooks by Zapier para llamar a la [Video Summarization API](https://wayin.ai/es/api-docs/video-summarization/) con `POST /api/v2/summaries`
2. Guardar el `id` de tarea devuelto en la misma fila
3. Añadir un paso de retraso o seguimiento programado
4. Llamar a `GET /api/v2/summaries/results/{id}` hasta que la tarea alcance `SUCCEEDED`
5. Escribir `summary`, `tags` y `highlights` de vuelta en Google Sheets

Ideal para:
Equipos editoriales, investigadores de contenido y marketers que mantienen una cola de vídeos en una hoja de cálculo.

### Submit Request

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example"
  }'
```

### Poll Request

```bash
curl -X GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/sum_proj_001 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"
```

---

## Ejemplo: Convertir grabaciones de Zoom en recaps para el equipo

Este flujo usa la [Video Summarization API](https://wayin.ai/es/api-docs/video-summarization/) para convertir grabaciones de reuniones, webinars o llamadas con clientes en recaps listos para compartir con el equipo.

Trigger:
Nueva grabación de Zoom en la nube.

Pasos:
1. Enviar la URL de la grabación a la [Video Summarization API](https://wayin.ai/es/api-docs/video-summarization/)
2. Consultar el endpoint de resultados hasta que `status` sea `SUCCEEDED`
3. Enviar el resumen y los highlights de la línea de tiempo a Slack
4. Guardar el resultado en Notion, Airtable, HubSpot o una Google Sheet

Ideal para:
Recaps de webinars, llamadas con clientes, reuniones internas, entrevistas y sesiones de formación.

---

## Ejemplo: Crear candidatos de clips desde nuevos vídeos de YouTube

Este flujo usa la [AI Clipping API](https://wayin.ai/es/api-docs/ai-clipping/) para detectar candidatos de clips cortos antes de que tu equipo decida qué exportar o publicar.

Trigger:
Nuevo vídeo de YouTube en un canal.

Pasos:
1. Enviar la URL de YouTube a la [AI Clipping API](https://wayin.ai/es/api-docs/ai-clipping/)
2. Establecer `enable_export` en `false` si solo necesitas timestamps y metadatos de clips
3. Consultar el endpoint de resultados hasta que la tarea esté completa
4. Enviar títulos, descripciones, timestamps, hashtags y puntuaciones de clips a Airtable o Google Sheets para revisión

Ideal para:
Creadores y equipos sociales que quieren una cola de revisión antes de renderizar o publicar clips.

### Submit Request

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example",
    "enable_export": false
  }'
```

---

## APIs recomendadas

| Objetivo del flujo | API |
|--------------------|-----|
| Convertir vídeos largos en clips cortos | [AI Clipping API](https://wayin.ai/es/api-docs/ai-clipping/) |
| Encontrar momentos concretos con una consulta en lenguaje natural | [Find Moments API](https://wayin.ai/es/api-docs/find-moments/) |
| Generar una visión estructurada del vídeo y highlights de la línea de tiempo | [Video Summarization API](https://wayin.ai/es/api-docs/video-summarization/) |
| Extraer transcripciones con tiempos y etiquetas de hablante | [Video Transcription API](https://wayin.ai/es/api-docs/video-transcription/) |
| Subir archivos locales de vídeo o audio antes de procesarlos | [Upload API](https://wayin.ai/es/api-docs/upload/) |
| Renderizar o reexportar clips seleccionados | [Clips Export API](https://wayin.ai/es/api-docs/clips-export/) |

---

## Buenas prácticas

- Guarda tu API key en la conexión de Zapier o en campos secretos. No la pongas en plantillas públicas de Zap.
- Guarda el `id` de tarea devuelto de inmediato para que los reintentos no pierdan el seguimiento de tareas en curso.
- Usa retrasos de Zapier o pasos de seguimiento programados para evitar consultas demasiado frecuentes.
- Gestiona siempre los estados `SUCCEEDED` y `FAILED`.
- Usa `enable_export: false` cuando tu equipo solo necesite timestamps y metadatos para revisión. Exporta los clips seleccionados más tarde con la [Clips Export API](https://wayin.ai/es/api-docs/clips-export/).

---

## FAQ

### ¿WayinVideo tiene una app nativa de Zapier?

Puedes conectar WayinVideo API con Zapier mediante **Webhooks by Zapier**. No hace falta una app dedicada de Zapier.

### ¿Puede Zapier resumir vídeos de YouTube con WayinVideo?

Sí. Usa un trigger de YouTube o una fila de Google Sheets que contenga una URL de YouTube, envíala a la [Video Summarization API](https://wayin.ai/es/api-docs/video-summarization/) y escribe el resumen y los highlights generados en la app que elijas.

### ¿Puede Zapier crear clips cortos desde vídeos largos?

Sí. Envía la URL del vídeo a la [AI Clipping API](https://wayin.ai/es/api-docs/ai-clipping/). Puedes devolver solo metadatos de clips para revisión o activar la exportación para renderizar clips cortos descargables.

### ¿Con qué frecuencia debe Zapier consultar el estado de una tarea?

Recomendamos consultar el estado cada **30 segundos**. Guarda el `id` de tarea para que cada paso de polling pueda recuperar el resultado correcto.
