# Workflow Make

> Conecte a WayinVideo API ao Make para criar cenários avançados de automação de vídeo para AI clipping, resumos de webinars, processamento em lote e saídas multilíngues.

## Integração de Automação de Vídeo Make

Use o **Make** para criar workflows avançados da WayinVideo com lógica de ramificação, iteradores, routers, filtros, retries e mapeamento de dados em várias etapas.

O Make é uma boa escolha quando sua automação precisa processar muitos vídeos, rotear tarefas bem-sucedidas e falhas de forma diferente ou executar diferentes APIs da WayinVideo com base em campanha, idioma, fonte ou tipo de conteúdo.

Com a WayinVideo API e o módulo HTTP do Make, você pode criar cenários de automação de vídeo para AI clipping em lote, reaproveitamento de webinars, resumos localizados, filas de revisão de conteúdo e pipelines de vídeo para CMS.

> A WayinVideo não exige um app dedicado do Make. Você pode se conectar pelo módulo **HTTP** do Make usando sua API key da WayinVideo.

---

## O Que Você Pode Automatizar com Make

- **Video clipping em lote**: monitore uma pasta do Google Drive, envie cada vídeo para a [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/) e roteie os clipes concluídos para armazenamento ou revisão.
- **Reaproveitamento de webinars**: gere resumos, destaques e clipes curtos a partir de gravações de webinars com a [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/) e a [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/).
- **Workflows de vídeo multilíngues**: use `target_lang` para criar resumos, transcrições e metadados de clipes localizados.
- **Workflows de exportação**: renderize clipes selecionados posteriormente com configurações personalizadas de legenda, reframe e exportação pela [Clips Export API](https://wayin.ai/pt/api-docs/clips-export/).

---

## Como Funciona

A maioria dos cenários Make segue este padrão:

1. **Trigger**: um novo arquivo, registro, payload de webhook ou cenário agendado inicia o workflow.
2. **Enviar**: o módulo HTTP envia uma requisição para um endpoint da WayinVideo API.
3. **Armazenar**: salve o `id` da tarefa retornado para consulta posterior.
4. **Consultar**: use verificações agendadas, loops ou o design do cenário para chamar o endpoint de resultado até que a tarefa chegue a `SUCCEEDED` ou `FAILED`.
5. **Rotear**: use routers e filtros para enviar resultados concluídos, falhas e caminhos de retry para módulos diferentes.

Recomendamos consultar o status da tarefa a cada **30 segundos**.

---

## Exemplo: Processar Vídeos do Google Drive em Lote

Este workflow usa a [Upload API](https://wayin.ai/pt/api-docs/upload/) para arquivos locais e a [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/) para gerar clipes curtos em lote.

Trigger:
Novos arquivos em uma pasta do Google Drive.

Passos:
1. Monitore uma pasta para novos arquivos de vídeo
2. Se necessário, envie cada arquivo pela [Upload API](https://wayin.ai/pt/api-docs/upload/)
3. Use um Iterator para enviar cada vídeo para a [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/)
4. Armazene cada `id` de tarefa retornado
5. Consulte cada tarefa e roteie os resultados concluídos para a próxima etapa
6. Salve clipes, metadados e valores de `export_link` no Google Drive, Airtable ou no seu CMS

Ideal para:
Agências, estúdios de conteúdo e equipes que processam muitos vídeos em lote.

### Requisição de Envio

```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": true,
    "resolution": "HD_720",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'
```

---

## Exemplo: Rotear Conteúdo de Webinar por Resultado

Este workflow usa a [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/) para recaps de webinars e pode opcionalmente enviar a mesma gravação para a [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/) para gerar clipes curtos.

Trigger:
Nova URL de gravação de webinar vinda de um formulário, CRM ou pasta de armazenamento.

Passos:
1. Envie a gravação para a [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/)
2. Consulte o resultado
3. Roteie tarefas bem-sucedidas para Slack, HubSpot, Notion ou Google Sheets
4. Roteie tarefas com falha para um log de erros e notifique o responsável pelo workflow
5. Opcionalmente, envie o mesmo vídeo para a [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/) para criar clipes curtos

Ideal para:
Equipes de marketing B2B que reaproveitam webinars em notas de vendas, resumos e clipes sociais.

### Verificação de Resultado

```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"
```

Quando a resposta contém `status: "SUCCEEDED"`, continue para os módulos seguintes. Quando a resposta contém `status: "FAILED"`, inspecione `error_message` se existir e roteie o cenário para retry, alerta ou revisão manual.

---

## Exemplo: Gerar Saídas Localizadas

Este workflow usa `target_lang` com a [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/), a [Video Transcription API](https://wayin.ai/pt/api-docs/video-transcription/) ou a [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/) para criar saídas localizadas.

Trigger:
Novo vídeo adicionado a uma fila de campanha.

Passos:
1. Crie uma lista de idiomas de destino para a campanha
2. Use um Iterator para enviar o mesmo vídeo uma vez por `target_lang`
3. Gere resumos, transcrições ou metadados de clipes para cada locale
4. Roteie cada resultado para o workspace regional, planilha ou fila de revisão correta

Ideal para:
Equipes globais de conteúdo que precisam de resumos de vídeo, transcrições ou descrições de clipes multilíngues.

### Requisição de Resumo Localizado

```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",
    "source_lang": "en",
    "target_lang": "ja"
  }'
```

---

## APIs Recomendadas

| Objetivo do Workflow | API |
|----------------------|-----|
| Transformar vídeos longos em clipes curtos | [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/) |
| Encontrar momentos específicos com uma consulta em linguagem natural | [Find Moments API](https://wayin.ai/pt/api-docs/find-moments/) |
| Gerar uma visão geral estruturada do vídeo e destaques de linha do tempo | [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/) |
| Extrair transcrições com tempos e labels de falantes | [Video Transcription API](https://wayin.ai/pt/api-docs/video-transcription/) |
| Enviar arquivos locais de vídeo ou áudio antes do processamento | [Upload API](https://wayin.ai/pt/api-docs/upload/) |
| Renderizar ou reexportar clipes selecionados | [Clips Export API](https://wayin.ai/pt/api-docs/clips-export/) |

---

## Boas Práticas

- Armazene sua API key em uma conexão do Make ou variável protegida.
- Salve IDs de tarefas em um data store, planilha ou banco de dados se o cenário se estender por várias execuções.
- Use routers para os estados `SUCCEEDED`, `ONGOING` e `FAILED`.
- Mantenha lotes pequenos o suficiente para evitar timeouts da plataforma e facilitar retries.
- Para clipes exportados, copie os arquivos de `export_link` para seu próprio armazenamento se o workflow precisar de acesso de longo prazo.

---

## FAQ

### A WayinVideo tem um app nativo do Make?

Você pode conectar a WayinVideo API ao Make pelo módulo **HTTP**. Um app dedicado do Make não é necessário.

### O Make pode processar vídeos em lote com a WayinVideo?

Sim. Use iteradores do Make para enviar vários vídeos à WayinVideo, armazenar cada `id` de tarefa e consultar resultados antes de rotear tarefas bem-sucedidas para o próximo módulo.

### O Make pode lidar com tarefas de processamento de vídeo com falha?

Sim. Use routers e filtros para separar respostas `SUCCEEDED`, `ONGOING` e `FAILED`. Para tarefas com falha, inspecione `error_message` se existir e roteie o cenário para retry, alerta ou revisão manual.

### O Make pode criar resumos de vídeo multilíngues?

Sim. Envie o mesmo vídeo com diferentes valores de `target_lang` para gerar resumos, transcrições ou metadados de clipes localizados para equipes regionais.